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ABSTRACT 


A general-purpose  cross-assembler  is  described.  The  cross-assembler 


written  in  PL/I,  has  been  implemented  on  an  IBM  370/168  using  the  time 


sharing  Conversational  Monitor  System  (CMS).  Absolute  binary  object  code 


will  be  produced.  Although  the  cross-assembler  has  been  designed  with  the 


intention  of  assembling  code  for  various  microprogrammable  machines,  even 


code  for  conventional  minicomputers  has  been  assembled 


Use  of  the  cross-assembler  is  discussed  assuming  a CMS  environment 


Included  are  the  disk-resident  files  to  facilitate  an  assembly.  Various 


pseudo-ops,  or  assembler  control  statements,  are  used  to  describe  the 


machine  for  which  an  assembly  is  done.  An  example  of  using  the  cross 


assembler  for  a parallel  microprogrammable  digital  signal  processor  (PMP-I) 
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INTRODUCTION 


A general-purpose  absolute  cross-assembler  has  been  written  in  PL/ I to 
run  on  an  IBM  370/1 b8,  accept  metalanguage  commands  to  define  a machine,  and 
then  cross-assemb 1 e code  foe  that  user-defined  machine.  The  cross-assembler 
has  been  used  under  IBM's  time-sharing  Conversational  Monitor  System  (HIS), 
and  this  report  will  discuss  t lu  cross-assembler  in  that  environment. 

To  begin,  let  us  examine  the  evolutional  history  of  this  c ross-assemb 1 er . 

Early  in  1975,  work  was  begun  at  M.l.T.  Lincoln  Laboratory  on  a Parallel 

Microprogrammab 1 e Processor  (known  as  the  PMP  or  more  specifically,  PMP-I). 

This  machine  was  designed  to  be  a high-speed,  programmable,  signal  processor. 

In  parallel  with  the  construction  of  the  hardware,  a set  of  microinstructions 

2 

for  the  PMP  was  developed.  This  led  to  the  generation  of  a cross-assembler 
written  in  PL/I  to  run  on  the  IBM  370/168  to  assemble  mnemonics  and  produce 
object  for  the  PMP ^ ^ . 

As  time  progressed,  a new  version  of  this  processor,  namely  PMP-1I,  was 
proposed.  This  coupled  with  the  increasing  use  of  programmable  microproces- 
sors in  other  applications  lead  to  the  creation  of  a general-purpose  cross- 
assembler  which  accepts  as  input  metalanguage  commands  which  contain  such 
information  as  word  length,  memory  size,  bit  meanings,  etc.  This,  then  is 
the  version  of  the  cross-assembler  to  be  discussed. 

The  remainder  of  this  memo  is  divided  essentially  into  two  major 
sections.  The  first  of  these  sections  attempts  to  look  at  the  cross-assembler 
in  the  general  sense,  and  attempts  to  explain  the  metalanguage  commands 
necessary  to  assemble  code  for  a particular  machine.  It  begins  by 


1 


explaining  the  input  language  rules  anticipated  by  the  cross-assembler.  This 
section  may  seem  unusual  to  those  familiar  only  with  minicomputer  code,  since 
the  cross-assembler  allows  several  microinstructions  to  be  coded  on  the  same 
line  and  assembles  these  into  the  same  program  memory  word. 

This  is  followed  by  a discussion  of  the  files  which  should  be  created  to 

t 

cross-assemble  code  for  a machine.  These  files  typically  contain  all  the 
necessary  metalanguage  statements,  thus  the  programmer  is  not  required  to  re- 
peat these  at  the  beginning  of  all  programs.  The  available  pseudo-ops  are 
then  discussed  in  depth,  explaining  when,  where,  and  why  they  should  appear. 

Section  I is  completed  with  a discussion  of  the  format  of  the  object  binary 
file  output  by  the  cross-assembler.  This  section  should  be  extremely  helpful 
for  the  user  who  must  create  a program  to  convert  cross-assembler  output  to 
some  medium  which  is  acceptable  input  to  the  machine  for  which  cross-assembly 
occurred. 

»] 

The  second  section  of  this  report  is  dedicated  to  an  example  of  the 
cross-assembler  in  action.  Naturally,  due  to  the  parentage  of  the  cross- 
assembler  (and  familiarities  of  the  author)  the  sample  machine  chosen  for 
this  example  was  PMP-I.  It  is  hoped  that  this  discussion,  along  with  the 
control  files  for  PMP-I  appearing  as  appendices,  will  give  the  user  enough 
information  to  extend  the  cross-assembler  for  the  particular  machine  desired. 

This  section  should  also  serve  as  a user's  guide  for  the  PMP-I  programmer. 

At  this  point  it  should  be  stressed  that  this  cross-assembler  has  been 
designed  to  produce  absolute  binary  output.  This  implies  that  for  a machine 
which  does  program  counter  relative  addressing  the  burden  of  coding  program 
counter  relative  constants  is  left  to  the  user.  One  must  subtract  the  value 
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of  the  current  program  counter  in  order  to  obtain  a program  counter  relative 
constant  (e.g.,  if  LABEL  is  to  be  expressed  relative  to  the  program  counter  one 
would  need  to  code  LABEL-*). 

Although  it  was  the  intent  of  this  cross-assembler  to  assemble  microcode, 
code  for  conventional  minicomputers  may  also  be  assembled.  In  the  latter  case 
the  user  would  define  all  instructions  belonging  to  the  same  non-zero  ex- 
clusivity set,  thus  indicating  to  the  cross-assembler  that  only  one  in- 

t 

struction  per  program  memory  word  will  be  allowed. 

As  a final  note,  perhaps  some  mention  of  the  architecture  of  the  cross- 
assembler  itself  is  in  order.  The  cross-assembler  performs  only  one-pass, 
but  a provision  for  forward  referencing  of  variables  (i.e.,  using  a label  be- 
fore its  definition)  has  been  built  in.  This  implies  the  cross-assembler  must 

» 

be  able  to  access  program  memory  locations  which  have  been  previously  as- 
sembled, in  order  to  resolve  any  forward  references  to  a label  at  the  time 
of  definition.  The  solution  to  this  has  been  to  maintain  a core-resident 

i 

array  of  all  possible  program  memory  locations.  Since  this  may  require  con- 
siderable working  space  for  machines  with  large  program  memories,  the  user 
has  control  to  specify  via  the  .DARCH  pseudo-op  which  portion  of  memory  must 

I 

be  generated,  and  therefore  which  portion  of  memory  is  available  for  use. 

I.  Characteristics  of  the  General  Cross-Assembler 

One  of  the  features  of  the  generalized  version  of  the  cross-assembler  is 
that  all  variables  dependent  on  the  machine  for  which  assembly  is  to  be  done 
must  be  defined  via  metalanguage  commands  at  each  assembly.  Tn  order  to 
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minimize  the  burden  placed  on  the  programmer  a method  has  been  devised  where- 
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by  the  required  metalanguage  definitions  may  be  prestored  as  a separate  disk 
file,  and  input  so  as  to  seem  transparent  to  the  user. 

This  section  is  devoted  to  in-depth  details  of  what  a user  must  do  in 
order  to  create  an  environment  to  faci]itate  assemblies  for  a given  machine. 

Special  attention  is  called  to  subsection  C,  which  gives  in-depth  definitions 
for  all  pseudo-ops  available,  including  the  metalanguage  commands  available 
for  defining  a machine  as  well  as  pseudo-ops  necessary  for  an  assembly. 

The  first  step  to  be  accomplished  is  to  divide  the  set  of  available 
i instruction  mnemonics  into  canonic  classes  (i.e.,  groups  of  instructions 

J ■ 

having  similar  operands).  The  canonic  classes  may  then,  be  defined  by  stat- 
ing minimum  and  maximum  number  of  allowable  operands,  indicating  any  required 
operands,  and  enumerating  elements  of  the  set  of  available  operands.  A set 
of  immediate  constant  (IC)  classes  also  needs  to  be  defined.  An  IC  class  has 
a lower  and  upper  limit,  and  an  associated  beginning  and  ending  bit  number  in 

i 

a program  memory  word.  Once  both  the  canonic  instruction  classes  and  the  IC 
classes  have  been  conceptualized,  the  user  is  ready  to  begin  creating  the 
appropriate  disk  files. 

I 

A.  Assembl er  Inp_ut_  Language  Sped  ficat  ions 

A "line"  of  code  to  be  assembled  should  be  a character  string  consisting 

| 

of  80  characters,  of  which  only  the  first  72  will  be  examined,  allowing  for 
the  use  of  sequence  numbers. 


Since  the  cross-assembler  was  designed  primarily  for  assembling  in- 
structions for  machines  which  may  be  microcoded,  coding  more  than  one 
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instruction  per  program  memory  word  is  allowable.  Multiple  instructions  to 
be  assembled  into  the  same  program  memory  word  may  be  coded  on  the  same  line 
and  separated  with  a semicolon  (;).  An  alternate  method  to  code  multiple  in- 
structions for  the  same  memory  location  is  to  code  them  on  consecutive  lines, 
with  the  first  non-blank  character  in  each  line  after  the  first  being  a comma 
(,).  Note  that  using  a comma  as  the  first  non-blank  character  does  not  in- 
dicate a continuation  of  the  previous  instruction,  but  rather  a continuation 
of  the  program  memory  location,  and  therefore  all  lines  should  end  at  the  end 
of  an  instruction. 

A line  will  be  scanned  and  all  characters  concatenated  to  form  what  is 
called  a token,  until  a delimiting  character  is  found.  Delimiting  characters 
are  members  of  the  set  {blank  ( ),  semicolon  (;),  comma  (,),  colon  (:), 
slash  (/),  equals  (=)}.  Tokens,  then,  are  either  labels,  opcodes,  or  oper- 
ands. Certain  of  the  delimiters  have  special  meaning.  A slash  always  indi- 
cates that  the  remainder  of  the  current  line  is  a comment,  a semicolon 
always  indicates  the  end  of  an  instruction.  A colon  appeari  g after  the 
first  token  of  a line  indicates  that  the  first  token  was  actually  a label, 
and  a comma  appearing  as  the  first  non-blank  character  indicates  a continua- 
tion of  the  contents  of  the  memory  location  being  assembled  on  the  previous 
line.  Other  than  these  few  simple  rules,  the  delimiting  characters  may  be 
used  interchangeably.  Naturally,  for  cosmetic  reasons  a standard  should  be 
chosen  for  a machine  and  adhered  to.  No  escape  characters  are  provided, 
since  no  text  string  assembling  is  implemented. 


When  codine  an  immediate  constant,  the  plus  (+)  and  minus  (-)  signs  have 
the  normal  unary  and/or  binary  meanings.  An  immediate  constant  may  contain 
any  number  of  plus  or  minus  signs,  but  no  parenthesized  expressions  are 
accepted.  For  example,  LABEL1+3,  and  LABEL1-LABEL2+3-LABEL3  are  both  accept- 
able immediate  constants. 

The  current  value  of  the  address  counter  (as  accumulated  by  the  cross- 
assembler)  is  specified  by  an  asterisk  (*) . Thus,  immediate  constants  of  the 
form  program  counter  t express  ion  may  be  coded  (e.g.  *+2 , *-3,  *+LABl , etc.). 
It  should  be  noted  that  this  merely  produces  an  absolute  immediate  constant. 
If  the  user  wishes  to  generate  a program  counter  relative  constant  (i.e.,  the 
effective  address  is  calculated  at  execution  time  by  adding  the  program 
counter  to  the  immediate  constant  field  stored  in  the  instruction)  then  at 
assembly  time  one  should  subtract  the  value  of  the  program  counter  (e.g., 
LABEL-*,  or  LABEL+3-*). 

Numbers  may  be  input  in  any  of  4 bases;  binary,  octal,  decimal,  or  hexa- 
decimal. The  default  input  base  is  initially  decimal,  but  may  be  changed  via 
the  .DIBASE  pseudo-op.  The  default  input  base  is  merely  the  base  used  to 
evaluate  a number  which  has  no  base  indicator.  At  any  time  the  user  may  code 
a number  in  any  of  these  4 bases  by  preceding  the  number  with  one  of  the  base 
indicators  (.B,  .Q,  .D,  .H,  or  ').  .B  indicates  a binary  number,  ,Q  an  octal 
number,  .D  a decimal  number,  .H  a hexadecimal  number,  and  the  apostrophe  (') 
indicates  an  octal  number.  Thus,  valid  numbers  might  be;  .B1101,  .Q75, 
.D290,  .H3AB,  '72,  or  .HA2.  Note  that  all  numbers  must  either  begin  with  a 
digit  or  one  of  the  base  indicators.  Thus,  if  the  default  input  base  is 
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hexadecimal  and  Che  user  wishes  to  code  the  constant  A2 , the  constant  0A2  must 
be  coded.  However,  .HA2  will  ul  : ulvavs  be  acceptable. 

B.  I's  in^  _the  General  Cross-Assembler 

Following  is  a discussion  of  the  steps  necessary  to  use  the  cross- 
assembler.  This  includes  a description  of  the  disk  files  which  may  be  gener- 
ated in  order  to  ease  the  burden  placed  on  the  user.  Creating  an  appropriate 
set  of  disk  files  frees  the  user  from  requiring  machine  definition  pseudo-ops 
in  all  source  programs. 

B.l  Creating  a_n  EXEC  File 

Clearly  the  user  will  desire  a special  1%  tailored  EXEC  file  to  contain 
the  necessary  CP/CMS  commands.  The  first  four  such  commands  should  be: 

&CONTROL  ERROR 

CP  LINK  PLIOPT  191  199  RR 

ACCESS  199  Z/Z 

GLOBAL  TXTLIB  SYSL1B  PLILIB  FORTLIB  GRLL 

The  first  of  the  above  four  statements  is  an  EXEC  control  statement  which 
spe  ifies  that  the  remaining  CP/CMS  commands  should  be  typed  at  the  terminal 
only  if  they  result  in  a non-zero  return  code.  The  subsequent  three  com- 
mands access  the  disk  containing  the  PL/1  libraries  necessary  to  run  the 
cross-assembler . 

A series  of  seven  FILEDEF  commands  is  then  necessary.  These  may  appear 
in  any  order.  The  following  section  attempts  to  describe  the  required  files, 
each  file  discussed  is  referenced  by  its  ddname. 
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1.  ARCFILE  - This  file  normally  contains  the  required 
metalanguage  pseudo-ops  to  define  a particular  machine 
(such  as  the  .DARCH,  .DCLASS's,  .DOP's,  etc).  It  is  read 
before  attempting  to  assemble  the  user's  program.  The 
only  difference  between  this  file  and  the  source  program  to 
be  assembled  is  that  the  input  statements  of  ARCFILE  are  not 
written  to  the  listing.  As  an  example,  if  we  have  a file 
whose  filename  is  PMP  and  whose  filetype  is  ARCH,  we  would 
code : 

FI  ARCFILE  DISK  PMP  ARCH  (LRECL  80  BLOCK  800  RECFM  FB 

2.  SFILE  - This  disk  file  is  the  source  file  to  be 
assembled.  It  has  been  found  convenient  to  let  file- 
name, filetype,  and  filemode  be  respectively  parameters  1, 

2,  and  3 of  the  EXEC.  Thus,  one  would  code: 

FI  SFILE  DISK  &1  62  6,3  (LRECL  80  BLOCK  800  RECFM  FB 

3.  ADRFILE  - This  is  an  output  disk  file  which  will  contain 
the  address  indices  for  the  object  binary  file.  The  name 
GENADR  DATA  has  typically  been  used,  although  if  something 
like  &1  DATA  were  used  the  object  binary  could  be  refer- 
enced even  after  another  file  was  cross-assembled.  Currently 
used  is: 

FI  ADRFILE  DTSK  GENADR  DATA  (BLOCK  80  RECFM  VB 


8 


4.  WILE  - This  is  another  output  file,  the  listing  file. 

In  order  to  write  this  file  on  disk  with  the  same  filename  as 
that  of  the  source  file  and  with  filetype  LISTING  one  would 
code : 

FI  WFILE  DISK  &1  LISTING  (LRECL  133  BLOCK  133  RECFM  F 


5.  BINFILE  - This  file  will  contain  the  object  binary  as 
produced  by  the  cross-assembler.  In  order  to  create  this 
file  as  a disk  file  with  the  same  filename  as  the  source  and 
with  filetype  OBJECT  one  would  code: 

FI  BINFILE  DISK  &1  OBJECT  (LRECL  80  BLOCK  800 

6.  TFILE  - This  output  file  will  consist  of  any  error  messages 
and  lines  producing  these  errors,  and  a statement  saying  how 
many  errors  were  produced  during  assembly.  The  file  was  intended 
to  be  sent  to  the  terminal,  which  is  done  by: 

FI  TFILE  TERMINAL  (LRECL  132 

7.  INSFILE  - This  file  should  contain  the  instruction  table 
as  produced  by  the  cross-assembler  by  the  .CREATI  pseudo-op. 

The  pseudo-op  .DEFLTI  makes  INSFILE  an  input  file,  and  .CREATI 
makes  INSFILE  an  output  file.  If  we  wished  this  file  to  have 
a filename  of  GENINS  and  filetype  DATA  we  would  code: 

FI  INSFILE  DISK  GENINS  DATA  (LRECL  80  BLOCK  800  RECFM  FB 
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After  all  of  the  above  FILEDEF  commands  the  LOAD  command  completes 
the  EXEC  file.  This  command  is  given  by: 

LOAD  GENASM  GENHASH  GENBILD  (NOMAP  NODUP  START 

B. 2 Generating  an  Instruction  Table 

Generating  an  instruction  table  which  is  written  to  disk  can  save 
the  user  a considerable  amount  of  time  v/hen  assembling.  The  table  consists 
of  all  defined  instruction  mnemonics,  and  control  information  for  the  cross- 
assembler  . 

In  order  to  create  this  table  the  user  must  assemble  a file  which  con- 
sists  solely  of  three  pseudo-ops:  .DARCH,  .DEFI,  and  .CREATI.  Naturally 

since  all  assemblies  must  begin  with  a .DARCH  this  pseudo-op  should  be  the 
first  statement  to  be  read.  This  should  be  followed  by  a .DEFI  for  each 
mnemonic  instruction  to  be  defined.  (See  Section  C for  use  of  the  .DEFI 
pseudo-op.)  Since  the  only  two  pseudo-ops  automatically  built  into  the 
instruction  table  are  .DARCH  and  .DEFI  the  remaining  pseudo-ops  must  also  be 
defined  with  a .DEFI  pseudo-op.  (For  the  exact  definitions  necessary  for 
these  see  Appendix  H.) 

After  the  entire  group  of  .DEFI  pseudo-ops  should  follow  a single 
.CREATI  pseudo-op.  This  causes  tJ*e  instruction  table  as  it  has  been  built 
to  be  written  as  a disk  file  such  that  it  may  be  recalled  during  future 
assemblies  with  the  .DEFLTI  pseudo-op. 
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It  has  proven  most  favorable  in  the  past  to  guarantee  that  the  file 
whose  ddname  is  ARCFILE  (see  section  B.l  above)  is  empty  while  generating 
the  instruction  table.  This  has  been  accomplished  by  temporarily  renaming 
the  file  assigned  to  ARCFILE  for  the  duration  of  the  assembly  generating  the 
instruction  table,  so  that  the  file  assigned  to  ARCFILE  is  a dummy  file. 


B . 3 Defining  and  Creating  the  Architecture  File 

The  cross-assembler  as  it  exists  allows  a great  deal  of  flexibility  to 
the  user.  Because  of  this,  at  each  assembly  time  the  assembler  must  receive 
the  metalanguage  commands  defining  the  machine  for  which  the  cross-assembly 
is  to  take  place,  the  canonic  classes  of  instructions,  allowable  operands  for 
a class,  etc.  Rather  than  require  these  definitions  at  the  beginning  of  all 
programs  to  be  assembled,  the  option  has  been  created  to  process  first  another 
file.  This  other  file  (whose  ddname  in  the  EXEC  file  is  ARCFILE)  is  assembled 
just  as  any  other  source  file,  with  the  exception  that  no  listing  file  will 
be  produced  for  any  source  statements  appearing  in  this  file.  By  using  this 
architecture  file  the  requirements  produced  by  the  generalization  of  the 
cross-assembler  are  made  transparent  to  the  casual  user. 

It  is  important  to  remember  that  each  time  the  cross-assembler  is  loaded 
it  starts  cold,  with  no  storage  areas  and  with  an  instruction  table  contain- 
ing only  the  two  pseudo-ops  .DARCH  and  .DEFI.  Therefore  clearly  the  first 
instruction  of  an  architecture  file  should  be  the  .DARCH  pseudo-op  which 
causes  the  cross-assembler  to  generate  the  necessary  storage  areas.  The  next 
thing  that  should  be  done  is  to  define  the  .DEFLTI  pseudo-op  by  using  the 
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.DEFI  pseudo-op.  This  is  done  with  the  statement: 

.DEFI  . DEFLTI  = '0,0, 0,0, 0,1, 0,4 

As  soon  as  this  definition  is  given  a .DEFLTI  should  be  issued  to  read 
the  default  instruction  table  from  disk  (which  defines  the  remaining  in- 
struction mnemonics).  Once  this  has  been  accomplished  the  remaining  structure 
of  the  assembler  should  be  defined. 

Perhaps  the  best  way  to  continue  at  this  point  is  to  define  the  instruc- 
tion canonic  classes.  This  task  is  accomplished  by  using  the  metalanguage 
commands  .DCLASS  and  .DOP,  a single  .DCLASS  required  for  each  canonic  class 
and  a .DOP  required  for  each  allowable  operand  of  that  class.  The  .DCLASS 
contains  such  information  as  canonic  class  number,  minimum  and  maximum  num- 
ber of  operands  which  may  be  coded  for  an  occurrence  of  an  instruction  of 
this  class,  the  number  of  . DOP ' s coded  for  this  class,  and  a special  number 
which  may  be  used  by  the  cross-assembler  to  indicate  a required  operand  which 
is  missing  (for  a complete  definition  of  .DCLASS  and  . DOP  see  Section  C) . 

The  .DOP  is  used  to  specify  an  operand  mnemonic  and  the  appropriate  bits  to 
be  set  by  an  appearance  of  this  operand,  it  associates  this  operand  with  the 
appropriate  canonic  class,  specifies  the  position  in  which  this  operand  may 
appear,  and  optionally  specifies  an  1C  type  for  instructions  requiring  use 
of  the  large  IC  field. 

Sometimes  an  exclusivity  set  may  exist  for  which  multiple  members  may 
appear  in  the  same  memory  location  as  long  as  a certain  field  is  the  same  for 
all  instructions.  For  example,  consider  the  case  where  multiple  shifters 
use  the  same  bit(s)  to  determine  which  type  of  shifting  should  occur.  In 
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situation  exists  for  a certain  exclusivity  set  by  using  the  define  exclu- 
sivity set  check  pseudo-op,  .DEXCLC. 

The  translation  tables  for  immediate  constants,  if  any  are  required, 
should  then  be  defined.  This  requires  a single  .DTRANS  to  allocate  storage 
for  the  translation  tables,  and  at  least  one  .DTTAB  pseudo-op  for  each  of 
the  translation  tables  to  specify  table  numbers.  It  is  important  that  the 
.DTRANS  pseudo-op  precede  any  .DTTAB,  since  it  defines  the  translation  table 
[ | environment  and  allocates  translation  table  storage. 

Once  any  necessary  translation  tables  have  been  defined  the  immediate 
constant  classes  should  be  defined  using  the  .DEFIC  pseudo-op.  It  is  im- 

f ' 

portant  to  remember  that  all  forward  referenced  variables  will  be  assumed 
to  be  members  of  IC  class  1. 

The  architecture  file  may  be  terminated  by  optionally  changing  either 
the  default  input  or  the  default  output  base.  The  default  input  base  is 


originally  decimal,  but  may  be  changed  with  the  .DIBASE  pseudo-op  to  either 
decimal,  binary,  octal,  or  hexadecimal.  It  specifies  the  base  of  a number 
not  preceded  by  a base  indicator  (the  base  indicators  are  .B,  .Q,  .D,  .H, 
or  ').  The  default  output  base  is  merely  the  base  used  when  creating  the 
address  and  object  fields  of  the  listing.  The  original  default  output  base 
is  octal,  although  the  .DOBASE  pseudo-OD  may  be  used  to  change  the  output 
base  to  either  octal  or  hexadecimal. 
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This  should  complete  the  architecture  file.  Note  that  the  architecture 
file  should  contain  solely  metalanguage  commands,  i.e.  , it  should  not  contain 
any  instructions  which  produce  executable  code. 

B . 4 Assembling _a  Program 

Once  all  of  the  previous  steps  have  been  completed  assembly  is  indeed  an 
easy  task.  The  user  must  merely  enter  the  name  of  the  EXEC  file,  followed 
by  the  filename  and  filetype  of  the  source  file  to  be  assembled.  For  example, 
if  an  EXEC  file  named  PMPASM  EXEC  has  been  created,  and  a user  wishes  to 
assembLe  a program  named  MYPROC.  FORTRAN  he  would  merely  need  to  enter  the 
command : 

PMPASM  MYPROC,  FORTRAN 

Assuming  the  EXEC  file  has  been  created  in  the  standard  way  discussed, 
this  would  produce  three  output  disk  files;  namely  MYPROC,  LISTING,  MYPROC 
OBJECT,  and  GENADR  DATA.  The  listing  file  may  be  either  printed  offline  or 
examined  from  the  terminal.  Typically  another  program  is  required  which  reads 
the  OBJECT  file  and  GENADR  DATA,  formats  the  object  binary,  and  produces  some 
type  of  output  on  a medium  which  may  be  input  by  the  machine  on  which  the 
cross-assembled  program  is  to  execute.  (Typically  this  might  be  paper  tape.) 

The  pseudo-ops  required  in  a user's  program  will  be  minimal.  Both  the 
. DEFC  and  . LOC  may  be  observed  frequently,  as  will  be  the  case  for  members  of 
user-defined  classes  15  and  16.  The  pseudo-ops  . DEFI,  . DIBASE,  and  . DOBASE 
might  also  appear  in  a user  program  but  with  a low  frequency.  The  remaining 
pseudo-ops  should  not  appear  in  a user  program,  since  these  necessar-.  meta- 
language definitions  may  be  more  easily  given  in  the  architecture  file. 
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As  a final  note,  it  should  be  mentioned  that  the  cross-assembler  antici- 
pates reading  80-character  records,  but  only  the  first  72  characters  are  ex- 
amined. This  allows  the  user  the  flexibility  of  using  standard  sequencing 
from  the  CMS  text  editor. 


C.  Pseudo-op  Definitions 


The  following  section  presents  a detailed  description  of  the  individual 
pseudo-ops  recognized  by  the  cross-assembler.  When  applicable  special  re- 
quirements for  individual  pseudo-ops  are  also  listed. 


Pseudo-op : 
Syntax : 
Purpose : 


Operands : 


. DARCH 

. DARCH  numbits , lowmem,memsize,numclass ,numi class 
The  .DARCH  pseudo-op  defines  the  word  size,  number  of 
program  memory  words  available,  number  of  instruction 
canonic  classes,  and  the  number  of  classes  for  an  im- 
mediate constant.  Since  allocation  of  most  storage 
areas  is  done  dynamically  when  this  pseudo-op  is  proces- 
sed it  MUST  be  the  first  line  read  by  the  cross-assembler. 
The  operand  numbits  specifies  the  number  of  bits  per 
instruction  word,  with  an  upper  limit  of  128  bits.  The 
operands  lowmem  and  memsize  specify  the  lower  and  upper 
addresses  respectively  of  the  section  of  program  memory 
to  be  generated  by  the  cross-assembler.  The  number  of 
canonic  classes  of  instructions  is  specified  by  nurocl ass , 
and  the  number  of  immediate  constant  classes  is  specified 


by  mimic lass. 
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Pseudo-op : 
Syntax : 
Purpose : 

Operands : 


.DCLASS 

. DCLASS  c lassnum,minops ,maxops ,numops , requiredops 
The  .DCLASS  pseudo-op  is  used  to  define  the  properties 
of  a canonic  class  of  instructions. 

The  canonic  class  classnum  will  consist  of  instructions 
which  must  have  at  least  minops  but  no  more  than  maxops 
operands  coded.  The  operand  numops  should  be  some  number 
less  than  or  equal  to  10  which  tells  the  cross-assembler 
how  many  operand  choices  are  to  be  given  for  this  class 
by  the  . DOP  pseudo-op. 

The  last  operand,  requiredops , permits  the  cross- 
assembler  to  flag  an  instruction  which  may  have  the  ap- 
propriate number  of  operands  coded,  but  is  missing  an 
essential  operand.  For  example,  let  us  consider  the 
READ  instruction  of  PMP-I,  which  takes  the  form: 

READ  1 C , [ B 1 , B2 , 0] 

where  (Bl,  B2 , 0]  indicates  one  or  more  of  B1 , B2  or  0 
may  be  coded.  This  instruction  reads  the  contents  of 
PE  RAM  location  1C  (where  If  spe.  ifies  some  immediate 
constant)  and  puts  the  result  into  one  or  more  of  the 
destination  registers  1,  aid  . The  immediate  con- 

stant is  a required  operand  and  therefore  the  cross- 
assembler  should  fla,  t ht  line: 


1 b 


READ  Bl,  B2 


since  even  though  it  contains  the  appropriate  number  of 
operands  an  essential  operand  is  missing.  If  the  bit  of 
requiredops  associated  with  the  operand  IC  is  set  = 1 
the  cross-assembler  will  be  able  to  flag  the  erroneous 
line  above. 

requiredops  specifies  a 15-bit  structure  with  each 
bit  = 1 if  the  corresponding  operand  (or  one  of  the  cor- 
responding group  of  operands)  must  be  coded,  or  a bit  = 0 
il  its  corresponding  operand  is  not  required.  The  first 
10  bits  are  assigned  directly  to  the  10  possible  operands 
as  defined  by  the  . DOP  pseudo-op.  Bit  1 (MSB)  is  as- 
sociated with  the  operand  to  be  indexed  as  the  first 
operand  in  the  list,  bit  2 with  operand  2,  etc.  In  the 
case  of  the  READ  instruction  above,  if  the  operands  are 
defined  such  that  1C  is  indexed  as  operand  1,  Bl  as 
operand  2,  B2  as  operand  3,  and  0 as  operand  4,  then 
bit  1 (MSB)  of  requiredops  should  be  =1.  That  is,  re- 
quiredops should  be  40000  . Bits  11-15  are  associated 

ft 

with  groups  of  operands  and  should  be  set  = 1 only  if 
one  member  of  that  group  must  be  coded  as  an  operand. 

The  bits  are  associated  as  follows: 


Bit  Number 


Associated  Operand  Group 


11 

1 

or  2 

12 

1 , 

, 2,  or 

3 

13 

2 

or  3 

14 

2, 

, 3 , or 

4 

15 

1 . 

. 2,  3, 

or 

As  an  example  of  a situation  in  which  one  of  the 
bits  11-15  of  requiredops  would  be  used  consider  the 
ADD  instruction  of  PMP-I.  It  is  of  the  form: 

ADD  { Y , TC} , [X,S,EO] 

where  the  first  operand  must  be  either  Y or  IC,  followed 
by  one  or  more  operands  chosen  from  X,  S,  or  EO.  Let  us 
consider  that  when  the  operands  are  defined  they  are  in- 
dexed such  that  Y is  indexed  as  operand  1 , IC  as  oper- 
and 2,  X as  operand  3,  S as  operand  4,  and  EO  as  oper- 
and 5.  Then  setting  bit  11  of  requi red ops  = 1 (i.e. 
requiredops  = 20o)  for  the  instruction  class  containing 

O 

ADD  will  cause  the  cross-assembler  to  verify  that  at 


least  one  of  Y or  IC  was  coded,  thus  flagging  the  invalid 


Pseudo-op : 


.DOP 


Syntax : .DOP  operand, bitrep, class, numinclass ,numopcoded , ict^  p 

Purpose : The  .DOP  pseudo-op  is  used  to  define  an  operand,  as- 

sociating it  with  a canonic  class,  and  specifying  the 
action  to  be  taken  when  the  defined  operand  is  coded. 
Operands : The  first  operand,  operand , is  the  character  representa- 

tion of  the  operand.  Only  the  first  four  characters  will 
be  recognized.  If  an  operand  is  to  be  an  immediate  con- 
stant this  field  must  be  the  2 characters  'IC'. 

bitrep  must  be  an  octal  constant  beginning  with 
an  apostrophe.  It  specifies  a word  which  will  be  logical- 
ly OR'ed  with  the  instruction  word  at  assembly  time, 
thereby  indicating  whi  h bits  should  be  set  = 1 when 
operand  appears.  If  the  binary  string  generated  from 
bitrep  is  shorter  than  an  instruction  word  it  will  be 
left  justified  and  padded  on  the  right  with  zeroes. 

Even  if  the  operand  is  an  IC,  bitrep  will  be  logically 
OR'ed  with  the  instruction  word. 

c lass  is  the  canonic  class  number  of  the  :anoni« 
class  of  instructions  being  defined.  numinc 1 ass  is  the 
element  number  of  this  particular  element  of  the  operand 
set  associated  with  canonic  class  class.  The  cross- 
assembler  merely  uses  numinc lass  as  an  index  to  the  oper- 
and set,  with  members  of  the  set  examined  from  low  index 


numopcoded  may  be  either  the  position  number  of 
this  operand  if  its  order  in  the  coded  operand  list  is 


Special  Notes: 
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essential,  or  zero  if  it  may  be  coded  in  any  position. 

The  final  operand  ictype  is  optional  and  is  only  coded 
if  the  operand  is  an  immediate  constant  (i.e., 
operand  = IC).  ictype  specifies  the  class  number  of  the 
IC  class  to  which  this  immediate  constant  belongs.  If 
ictype  = 1 is  coded  then  the  ictype  as  specified  in  the 
individual  instruction  definition  (.DEFI)  will  be  used 
for  lower  and  upper  limits. 

1.  Each  operand  as  it  is  defined  via  the  . DOP  pseudo- 
op becomes  a reserved  mnemonic  and  therefore  may 
not  be  used  as  a label. 

2.  If  the  operand  is  'IC'  then  numopcoded  should  never 
bo  zero. 

3.  The  cross-assembler  searches  the  set  of  available 

1 

operands  starting  with  that  operand  with 
numinclass  = 1 and  using  numinclass  as  an  index 
through  the  set.  Therefore  if  an  operand  may  be 
either  an  IC  or  something  else  the  other  possi- 
bilities should  have  a lower  numinclass  than  'IC' 
in  order  to  prevent  the  cross-assembler  from 
attempting  to  evaluate  a reserved  mnemonic  as  an 
immediate  constant. 
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Pseudo-op : 
Syntax: 
Purpose : 


Pseudo-op : 

Syntax: 

Purpose: 


Pseudo-op: 
Syntax : 
Purpose : 


. DEFLTI 
. DEFLTI 

This  pseudo-op  retrieves  the  default  instruction  table 
from  the  disk.  It  causes  the  disk  file  defined  by  a 
FILEDEF  command  in  the  F.XEC  file  with  a ddname  of  INSFILE 
to  be  read.  This  allows  the  user  to  obtain  the  prede- 
fined instruction  set. 

. CREATI 
. CREATI 

The  .CREATI  pseudo-op  is  used  to  create  a disk  in- 
struction file  by  writing  the  current  instruction  table 
to  a disk  file.  The  filename  is  defined  by  a FILEDEF 
in  the  EXEC  file  with  a ddname  of  INSFILE.  This  pseudo- 
op is  used  when  initially  defining  an  instruction  set, 
or  may  be  used  to  add  more  mnemonics  to  a predefined 
instruction  set. 

.DEFI 

. DEFI  ins t=b i ts ,exc 1 , ictype , icreq , f ref , pseudo ,xmine , type 
The  .DEFT  is  used  to  define  an  instruction  mnemonic. 

This  instruction  mnemonic  is  added  to  the  instruction 
table  for  the  current  assembly  only  unless  a .CREATI 
pseudo-op  follows  before  completion  of  assembly. 
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Operands : 


The  mnemonic  itself  is  given  as  inst . This  operand 


should  be  a character  string,  with  only  the  first  seven 
characters  examined  by  the  cross-assembler.  The  operand 
bits  specifies  the  instruction  word  bits  which  are  set  to 
1 by  the  instruction.  bits  must  be  an  octal  number, 
must  be  preceded  by  an  apostrophe,  and  may  not  be  anv 
longer  than  dictated  by  the  number  of  bits  in  an  in- 
struction word.  The  cross-assembler  will,  however,  ac- 
cept a shorter-than-necessary  string  which  it  left- 
justifies  with  zero  fill  on  the  right. 

The  operand  excl  specifies  a 10-bit  structure  with 
each  bit  representing  an  exclusivity  set.  (Instructions 
which  are  mutually  exclusive,  i.e.  no  more  than  1 may  be 
coded  per  line,  belong  to  the  same  exclusivity  set.  An 
instruction  may  belong  to  more  than  1 exclusivity  set.) 

The  operand  ictype  specifies  the  IC  class  number  if 
the  instruction  uses  the  large  IC  field,  or  0 if  this 
field  is  not  used.  This  field  is  used  whenever  the  class 
of  an  IC  is  specified  by  the  . DOP  to  be  = 1.  icreq 
should  be  = 1 if  the  large  IC  field  is  required  for  this 
instruction,  =0  if  not.  f ref  should  be  =1  if  forward 
referencing  is  allowable,  =0  if  not.  pseudo  should  be 
=1  if  the  instruction  is  a pseudo-op,  =0  if  not. 
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Pseudo-op : 
Syn tax : 
Purpose: 


Operands : 


Pseudo-op : 


Syntax: 
Purpose : 


xmine  should  be  =1  if  the  operands  coded  for  an  in- 
struction should  be  examined  with  appropriate  bits  being 
set  even  if  an  insufficient  number  of  operands  were  coded, 
and  xmine  should  be  =0  if  coding  an  insufficient  number 
of  operands  should  cause  no  operands  to  be  examined. 
Finally,  the  operand  type  specifies  the  canonic  class 
number  of  the  instructions  (or  pseudo-op  class  for 
pseudo-ops) . 

. DTRANS 

. DTRANS  numt rans , s izet rans 

The  pseudo-op  .DTRANS  is  used  to  define  the  translation 
tables  optionally  used  by  an  immediate  constant  class. 

It  defines  the  number  of  translation  tables  needed  as 
well  as  the  size  of  the  largest  table.  This  pseudo-op 
must  precede  any  attempts  to  specify  translation  table 
elements  with  the  . DTTAJJ  pseudo-op. 

The  total  number  of  translation  tables  necessary  is  given 
by  numt rans . The  second  operand,  s izet  rans , specifies 
the  number  of  elements  in  the  largest  translation  table. 

. DTTAB 

. DTTAB  num,of  f set , beg  index , value  1 ,value2 , . . . 

The  .DTTAB  pseudo-op  is  used  to  specify  elements  of  an 
immediate  constant  translation  table. 


J 
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Operands : 


The?  first  operand,  num,  specifies  the  number  of  the 
translation  table.  offset  is  the  offset  amount  which 


Pseudo-op : 
Syntax : 
Purpose : 


Operands : 


Pseudo-op : 
Syntax: 


must  be  added  to  an  immediate  constant  to  convert  this 
to  a table  index  from  1 to  n,  where  n is  the  number  of 
elements  in  the  table.  The  operand  begindex  merely  speci- 
fies  which  table  entry  follows,  and  valuel , val ue2 , etc. 
are  the  actual  translation  table  entries  (with  valuel 
being  the  begindex*^  table  entry). 

. DF.XCLC 


.DEXCLC  exclset ,beginbit ,endbit 

The  .DEXCLC  pseudo-op  defines  an  exclusivity  set  check 
which  may  allow  more  than  one  member  of  an  exclusivity 
set  to  coexist  on  the  same  instruction  line.  It  is  used 
for  exclusivity  sets  where  a particular  field  is  used 
by  all  members  of  this  set,  but  multiple  members  may  co- 
exist if  this  field  is  to  be  the  same  for  all  members. 
The  exclusivity  set  number  (from  1 to  10)  is  given  as 
the  first  operand,  exclset . The  bit  numbers  correspond- 
ing to  the  begin  and  end  of  the  field  used  by  both  in- 
structions are  specified  respectively  by  the  operands 
beginbit  and  endbit . 

.DEFIC 

.DEFIC  class, lowlimit ,hi limit , begin , end , t ran tab 
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Purpose : 


Operands : 


Note: 


Pseudo-op : 
Syntax: 
Purpose : 


This  pseudo-op  specifies  upper  and  lower  limits  for  an 
immediate  constant  class,  the  begin  and  end  bit  positions 
of  the  instruction  word  for  an  IC  of  this  particular 
class,  and  a translation  table  number  if  the  immediate 
constant  to  be  coded  requires  some  translation  before 
it  is  put  in  the  instruction  word. 

The  operand  class  specifies  which  IC  class  is  being  de- 
fined. lowlimit  and  hilimi t define  respectively  the 
lower  and  upper  values  which  an  IC  of  this  class  may 
attain.  begin  and  end  specify  begin  and  end  bit  posi- 
tions of  the  instruction  word  to  be  used  by  this  IC 
class  (with  the  MSB  being  called  bit  1),  and  trantab 
either  is  the  number  of  a translation  table  necessary  to 
convert  an  IC  coded  to  a value  placed  in  the  instruction 
word,  or  0 if  no  such  translation  is  necessary. 

IC  class  1 should  always  define  the  "large  IC  field", 
since  class  1 limits  are  used  for  resolving  forward 
references  as  they  are  defined. 

.DIBASE 

.DIBASE  base 

The  .DIBASE  pseudo-op  may  be  used  to  define  the  default 
input  base,  that  is,  the  base  assumed  for  any  numerical 
immediate  constant  not  preceded  by  a base  indicator. 
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Operand : 


Pseudo-op ; 
Syntax: 
Purpose : 


Operand : 
Pseudo-op : 
Syntax : 
Purpose : 


Operand : 


Pseudo-op : 
Syntax : 
Purpose : 


Operand : 


The  single  operand  base  should  be  either  2,  8,  10, 
or  16  (assuming  the  previous  default  input  base  was 


10). 

.DOB AS E 

.DOBASE  base 

The  .DOBASE  pseudo-op  defines  the  output  base  used 
in  printing  the  address  and  object  columns  of  the 
listing. 

The  single  operand  base  may  be  only  8 or  16. 

.LOC 

.LOC  value 

The  .LOC  pseudo-op  is  used  to  set  the  address  location 
counter.  It  is  not  allowable  to  set  this  counter  to  a 
value  less  than  the  current  value. 

The  single  operand  value  should  be  the  value  to  which 
the  address  counter  is  to  be  set. 


. DEFC 

.DEFC  name=value 

The  .DEFC  pseudo-op  is  used  f assign  a value  to  a given 
mnemonic  label. 

The  operand  name  is  the  mnemonic  label  to  be  defined. 
Only  the  first  seven  characters  are  recognized  by  the 
cross-assembler.  The  value  assigned  is  given  by  the 
operand  value , which  may  be  any  predefined  label  or  any 


constant . 
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Pseudo-op : 
Syntax : 
Purpose : 


Example : 


Pseudo-op : 
Syntax : 
Purpose : 


Example : 


User-defined  Pseudo-op  Class  15 
1 mnemonic  (opcode  with  no  operands) 

This  pseudo-op  class  allows  the  user  to  define 
mnemonics  that  allow  a certain  bit  (or  bits)  to  be 
set  =1  in  all  subsequent  instruction  words. 

Assume  a user  is  dealing  with  a 24-bit  machine  where 
bit  14  (with  MSB  = bit  1)  is  a mask  bit  for  interrupts, 
i.e.,  no  inteirupts  are  allowed  when  bit  14  = 1,  inter- 
rupts are  aLlowed  when  bit  14  = 0.  The  user  is  able  to 
define  a pseudo-op,  say  MSK,  which  will  cause  the  mask 
bit  to  be  set  to  1 in  all  subsequently  assembled  in- 
struction words  until  another  instruction  (of  user- 
defined  pseudo-op  class  16)  turns  this  bit  off  again. 

To  define  the  instruction  MSK,  the  user  would  code: 

■DEFT  MSK= ' 00002 ,0,0,0,0,1,0,15 
User-defined  Pseudo-op  Class  16 
1 mnemonic  (opcode  with  no  operands) 

This  pseudo-op  class  allows  the  user  to  define  mnemonics 
that  allow  a bit  ( or  bits)  set  = 1 by  an  instruction  of 
pseudo-op  class  15  to  be  cleared  again  (=0)  in  all  sub- 
sequent instruction  words. 

Let  us  again  consider  the  example  discussed  under  "user- 
defined  Pseudo-op  Class  15".  After  the  user  has  com- 
pleted the  section  of  code  where  bit  14  = 1 (i.e.. 
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interrupts  were  disabled) 
again  produce  object  code 
should  be  enabled  again), 
say  UNMSK,  may  be  defined 
MSK  pseudo-op.  To  define 
would  code: 


he  wishes  the  assembler  to 
with  bit  14=0  (i.e.,  interrupts 
To  accomplish  this  a pseudo-op, 
which  will  undo  the  work  of  the 
the  pseudo-op  UNMSK  the  user 


.DEFI  UNMSK= '00002,0,0,0,0,1 ,0,16 

D . Outputs  from  the  Gen e r a 1 C r oss-Assembler 

The  cross-assembler  produces  several  outputs  including  a listing  file,  a 
file  designed  for  the  terminal  (consisting  of  error  messages  and  statements 
producing  these  errors),  and  a binary  object  file  with  an  address  file  to 
serve  as  an  index.  Assuming  the  listing  file  has  been  written  to  disk  it  may 
be  either  printed  offline  or  typed  at  a terminal,  as  the  user  may  desire. 

The  file  intended  for  the  terminal  is  to  give  the  user  an  indication  of  the 
success  of  the  assembly,  and  there  is  usually  no  reason  to  save  this  file. 

The  binary  object  file  usually  will  require  another  follow-up  program 
to  read,  format,  and  transmit  the  data  to  some  medium  so  that  it  may  be  ac- 
ceptably input  to  the  user's  machine.  It  is  this  binary  object  file  and 
associated  address  file  upon  which  we  shall  focus  our  attention  in  this 
sect  ion. 

Only  the  program  memory  locations  for  which  an  instruction  was  coded  will 
be  written  to  the  binary  object  file,  thus  creating  the  need  for  the  associated 
address  file.  The  address  file  consists  of  pairs  of  begin  and  end  addresses. 
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If  an  end  address  is  one  less  than  the  begin  address  this  means  that  there 
were  no  binary  object  words  written  for  this  pair,  and  it  may  be  ignored. 
Since  only  the  . LOC,  pseudo-op  allows  an  address  change  of  more  than  one  loca- 
tion, this  only  occurs  if  the  source  program  begins  with  a .LOC,  or  if  two 
.LOC  pseudo-ops  are  coded  consecutively  with  no  intervening  instructions. 
(What  actually  happens  is  that  when  a .LOC  is  encountered  the  cross-assembler 
decrements  its  address  counter  which  points  to  the  address  of  the  next  avail- 
able program  memory  word,  writes  this  value  to  the  address  file,  then  sets 
its  address  counter  to  the  value  of  the  operand  of  the  .LOC  and  writes  the 
value  to  the  address  file.)  The  address  file  is  terminated  by  a pair  of  be- 
gin and  end  addresses,  both  of  which  are  999999. 

The  address  file  is  created  using  record-oriented  transmission  in  PL/1. 
Assuming  ADR__CNT  is  a 31-bit  binary  fixed  variable,  then  a typical  output 
statement  to  the  address  file  might  be: 


WRITE  FILE  (ADRFII.E)  FROM  (ADR  CNT)  ; 

Thus  a PL/I  input  statement  should  also  read  into  a 31-bit  binary  fixed 
variable,  say  ADR_INI)EX  with  a statement  similar  to: 

READ  FILE  (ADRFII.E)  INTO  (ADR  INDEX); 

As  previously  mentioned  in  section  B.l  the  address  file  is  created  with  ddname 
ADRFILE  having  a blocksize  =80  and  variable  blocked  record  format  (i.e.,  in 


the  FILEDEF  use  BLOCK  80  RECFM  VB). 


The  binary  object  file  is  created  using  PL/I  stream-oriented  transmis- 
sion. Each  memory  location  is  written  with  a B-format  (bit-string  format)  of 


length  NUMBITS  where  NUMBITS  stands  for  the  number  of  bits  in  the  user's 
machine.  Thus  assuming  the  binary  object  is  stored  in  an  array  called  BIN  COD 
and  ADR_CNT  is  a 31-bit  binary  fixed  variable,  a typical  PL/I  output  statement 
to  the  file  BINFILE  might  look  like: 

PUT  FILE  (BINFILE)  EDIT  (BIN  COD  ( ADR _CNT)X B (NUMBITS )) ; 

Note  that  using  a record  length  of  80  and  blocksixe  800  (i.e.,  in  the  FILEDEF 
using  LRECL  80  BLOCK  800  RECFM  FB)  exactly  one  program  memory  location  per 
record  is  written  only  for  a machine  with  an  80-bit  program  memory  word. 

That  is,  a single  output  record  does  not  necessarily  correspond  to  a single 
program  memory  location. 

II.  Example  of  Creating  a Tailored  Vers  ion  of  the  Cross-Assembler  for  PMP-I 

This  section  is  devoted  to  a discussion  of  a specific  example  of  using 
the  general  cross-assembler  for  the  Parallel  Mic. reprogrammable  Processor  (or 
PMP-I)  built  at  Lincoln  Laboratory.  It  is  also  intended  to  serve  as  a user's 
guide  for  those  wishing  to  use  the  cross-assembler  to  assemble  PMP-1  code. 

Perhaps  a brief  word  describing  the  architecture  of  PMP-I  is  in  order. 
Conceptually  a PMP  consists  of  a control  unit  and  a number  of  identical 
processing  modules  (PM's),  each  containing  a processor  element  (PF)  and  a 
data  memory.  The  sole  PMP-I  in  existence  contains  a single  PE,  but  if 
multiple  PE's  are  present  all  perform  the  same  operation  simultaneously. 
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Both  the  controller  and  PE's  have  a 24-bit  architecture.  The  actual  data- 
processing  tasks  are  performed  in  the  PE(s),  while  the  controller  sequences 
through  the  program,  computes  addresses  for  PF.  RAM(s)  and  PM  data  memories, 
and  communicates  with  external  devices. 

A 60-bit  program  memorv  word  consists  of  38  PE  control  bits,  a 12-bit 
immediate  constant  (IC)  field,  and  a 10-hit  controller  field.  The  10-bit 
controller  field  may  be  further  subdivided  into  an  8-bit  field  specifying 
which  of  256  controller  operations  is  to  take  place,  a bit  to  specify  whether 
or  not  the  instruction  pipeline  is  inhibited  on  a branch  instruction,  and  a 
bit  to  specify  the  source  for  the  PE  RAM  address  used.  For  completeness,  a 
diagram  of  the  PE  architecture  appears  as  Appendix  L,  and  a diagram  of  the 
60-bit  program  memory  word  appears  in  Appendix  D. 

Step  1 in  the  procedure  of  using  the  cross-assembler  for  a new 
machine  is  to  group  the  instruction  mnemonics  into  canonic  classes,  each 
canonic  class  consisting  of  members  having  the  same  operand  set.  The  canonic 
class  divisions  for  PMP- I are  given  in  Appendix  B.  At  a first  glance,  it  may 
appear  that  canonic  classes  11  and  12  (the  Bl-  and  B2-shift  instructions  re- 
spectively) have  the  same  operand  set  as  canonic  class  2,  namely  all  three 
classes  require  a single  immediate  constant  (IC)  as  an  operand.  However 
upon  more  careful  inspection  it  is  seen  that  the  IC  in  canonic  class  2 is 
intended  for  program  memory  bits  49-60,  while  the  IC  in  canonic  class  11 
(Bl-shift  instructions)  affects  the  Bl-shift  bits  29-30  and  the  IC  in  canonic 
class  12  (B2-shift  instructions)  affects  the  B2-shift  bits  35-36.  Thus 


criteria  for  forming  canonic  classes  should  be  that  all  members  of  a class 


should  have  liii  same  operand  set,  and  if  that  operand  set  includes  an  1C  that 
U must  intended  t i the  same  position  in  the  program  memory  word. 

A somewhat  <-.i  ier  task  is  determining  the  IC  classes.  This  is  ac- 
complished bv  treat  in  a list  of  all  possible  bit  positions  for  which  an  IC 
is  intended,  and  for  each  of  these  groups  deciding  the  limits  that  may  be 
placed  on  an  IC.  For  PMP-I,  there  are  3 possible  locations  in  a program 
memory  word  for  which  an  IC  is  intended,  namely  the  large  IC  field  (bits 
49-60),  the  Bl-shift  bits  (bits  29-30),  and  the  B2-shift  bits  (bits  35-36). 
Furthermore,  on  the  first  of  these  groups  it  is  convenient  to  place  5 limit 
restrictions,  namely  -2048.  to  2047 , 0 to  2047,  0 to  1023,  0 to  4095,  and 
0 to  4.  Thus  the  7 IC  classes  as  listed  in  Appendix  C were  created.  (Note 
that  a translation  table  is  convenient  for  the  two  B-shift  classes  in  order 
to  allow  a programmer  to  code  an  1C  of  1-4  indicating  the  number  of  bits  to 
shift,  but  allows  the  cross-assembler  to  produce  the  code  as  listed  in  the 
bit  definitions  of  Appendix  D.) 

Determining  the  exclusivity  sets  requires  careful  examination  of  the 
program  memory  bit  assignments.  Exclusivity  sets  are  useful  to  indicate  in- 
structions which  are  mutually  exclusive  (i.e.,  may  not  appear  in  the  same 
program  memory  word)  but  do  not  try  to  set  the  same  bits  = 1.  The  cross- 
assembler  performs  a logical  AND  as  each  instruction  is  added  to  a program 
memory  word,  producing  an  error  message  if  a non-zero  result  is  obtained. 
Thus,  exclusivity  sets  should  consist  of  instructions  requiring  the  same 
program  memory  word  bits  but  may  not  necessarily  produce  a conflict  message 
from  tli is  logical  ANDing. 
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Three  immediate  exclusivity  set  candidates  for  PMP-I  are  ALU1  operations 
(bits  1-6),  ALU2  operations  (bits  7-12),  and  control  opcodes  (bits  41-48). 
More  careful  consideration  indicates  an  exclusivity  set  for  the  instructions 
that  use  the  recirculating  bus  (bit  15)  will  indicate  a conflict  if  an 
erroneous  attempt  is  made  to  set  the  recirculating  bus  to  the  contents  of 
the  M register  for  clocking  into  one  of  the  B registers,  and  to  the  contents 
of  a PE  RAM  location  for  clocking  into  the  other  B register.  This  eliminates 
a problem  with  the  first  version  of  the  cross-assembler  for  PMP-I  which  did 
not  flag  the  erroneous  combination  of  the  READ  and  MOVM  instructions. 

Examining  bits  31,  32  indicates  that  these  bits  control  the  shifting 
that  may  occur  either  in  B1  or  B2.  Thus  B1  and  B2  may  both  perform  shifts 
simultaneously  as  long  as  they  are  the  same  type  of  shift.  This  adds  an 
extra  complexity:  the  B-shift  instructions  are  mutually  exclusive  only  if 

they  attempt  to  set  bits  31,  32  differently.  This  problem  is  overcome  by 
defining  an  exclusivity  set  for  the  shift  instructions  as  well  as  an  ex- 
clusivity set  check  (via  .DEXCLC)  which  examines  bits  31,  32  and  produces  no 
error  message  if  these  settings  are  the  same.  The  final  exclusivity  set  is 
defined  for  PE  RAM  access  instruct  ions, to  cover  the  case  of  an  attempt  to 
read  and  write  the  RAM  simultaneously  where  either  the  read  or  write  (but 
not  both)  use  the  contents  of  the  S-register  (PEAS=1)  as  its  effective 
address . 

These  6 exclusivity  sets  complete  those  defined  for  PMP-I.  Perhaps  it 
may  not  be  immediately  obvious  why  other  classes  were  not  defined.  For  ex- 
ample, one  might  notice  that  an  attempt  to  perform  a logical  right  shift  of 
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4 bits  as  well  as  a logical  right  shift  of  2 bits  in  B1  would  not  produce  an 
exclusivity  set  conflict.  However  both  of  these  instructions  would  attempt 
to  set  bit  28=1  and  the  cross-assembler  would  detect  this  as  a conflict  when 
it  logically  ANDed  the  two  bit  strings  of  the  instructions. 

Once  the  language  of  the  machine  has  been  conceptualized  in  this  manner 
the  user  is  ready  to  begin  creating  his  definition  files  as  indicat'd  below. 

A.  Setting  lip  the  EXEC  for  PMP-I 

The  F.XF.C  file  used  for  assembling  PMP-I  code  was  named  PMPASM  EXEC  and 
appears  as  Appendix  F.  The  first  four  lines  are  standard  and  appear  as  given 
in  Part  T,  Section  B.l.  The  FILEDEFS  for  ddnames  SFILE,  ADRFILE,  WFILE, 
BINFILE,  and  TFILE  are  also  the  standard  forms  as  given  in  Part  I,  Section 
B.l. 

The  name  chosen  for  the  architecture  file  was  PMP  ARCH,  and  thus  the 
FILDEF  for  ARCFILE  is: 

FI  ARCFILE  DISK  PMP  ARCH  (LRECL  80  BLOCK  800  RECFM  FB 

Similarly  the  name  chosen  for  the  disk  instruction  file  was  PMPINS  DATA,  and 
thus  the  FILEDEF  for  INSFILE  is: 

FI  INSFILE  DISK  PMPINS  DATA  (LRECL  80  BLOCK  800  RECFM  FB 

B.  Generating  an  Instruction  Table  for_PM_P-J[_ 

The  PMP-I  instruction  table  was  created  by  an  assembly  of  the  file 
PMP INST  FORTRAN.  This  file,  which  appears  as  Appendix  H,  begins  with  the 
. DARCH  pseudo-,  p for  PMP-I  which  must  declare  PMP-I  as  a bO-bit  machine. 
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having  12  instruction  canonic  classes  and  7 IC  classes.  The  lower  and  upper 
memory  limits  are  not  particularly  relevant,  since  PMPINST  FORTRAN  will  con- 
tain no  source  code  which  will  produce  executable  code. 

The  next  12  statements  are  the  required  .DEFI  statements  to  define  the 
pseudo-ops  not  built-in  to  the  cross-assembler.  This  includes  all  pseudo-ops 
except  . DARCH  and  .DEFI,  and  these  definitions  should  be  present  in  all  files 
generating  an  instruction  table. 

The  remainder  of  PMPINST  contains  a .DEFI  pseudo-op  to  define  each  of 
the  mnemonics  given  in  Reference  2.  Each  .DEFI  is  created  from  the  defini- 
tion (as  given  in  Reference  2),  memory  bit  assignments  (Appendix  D) , exclu- 
r 

sivity  set  definitions  (Appendix  E) , IC  class  table  (Appendix  C) , canonic 
class  table  (Appendix  B) , and  a list  of  control  opcodes  (Reference  2, 

Appendix  A).  As  an  example,  let  us  consider  the  mnemonic  BMPY. 

This  instruction  requires  an  addition  (F=A  PLUS  B)  in  both  ALUs,  clock- 
ing of  both  A1  and  A2  if  the  MSB  of  the  M-register  is  non-zero,  and  logically 

I 

left-shifting  the  contents  of  the  M-register  one  bit.  From  the  ALU  function 

select  table  (Appendix  K)  we  see  that  for  the  function  F=A  PLUS  B we  must 

choose  the  ALU  control  lines  S_,  S, , S„,  S~,  C , and  M such  that  S„ , S,  , 

0 1 2 3 n 2 1 

M=0  and  S^,  S^,  and  C^=l.  Since  the  addition  is  to  be  performed  in  both  ALUs, 
this  means  bits  1,  4,  5,  7,  10,  and  11  should  be  set  =1.  Furthermore,  ex- 
amining  the  memory  bit  assignments  given  in  Appendix  D indicates  that  M is 
logically  left-shifted  one  bit  if  bit  18=1,  and  A1 , A2  will  be  clocked  when 
the  MSB  of  M is  1 if  bits  22,  23,  24  are  given  as  Oil. 


Thus,  the  60-bit  word  for  BMPY  may  be  given  (in  octal)  by: 
46460103000000000000.  BMPY  requires  the  use  of  both  ALU1  and  ALU2 , thereby 
belonging  to  exclusivity  sets  9 and  10.  Since  these  are  the  two  LSB's  of  the 
exclusivity  set  field,  the  exclusivity  number  coded  is  3.  Since  BMPY  does 
not  require  (nor  allow)  any  1C,  the  IC  class  is  coded  as  0,  and  both  flags 
used  to  indicate  a required  IC  and  when  forward  referencing  is  allowed  are 
also  0.  BMPY  is  not  a pseudo-op  therefore  the  pseudo-op  flag  should  be  0, 
and  since  no  operands  are  allowed  the  flag  to  indicate  whether  to  examine 
any  operands  if  an  insufficient  number  were  coded  is  not  applicable  (and 
therefore  coded  as  0).  From  the  canonic  class  table  we  find  BMPY  belongs 
to  canonic  class  1.  Thus  the  definition  line  for  BMPY  becomes: 

.DEFI  BMPY=’ 46460103, 3, 0,0, 0,0, 0,1 

When  all  instruction  mnemonics  have  been  similarly  defined  and  stored 
as  part  of  the  instruction  table  it  is  important  to  write  this  table  to 
disk.  This  is  accomplished  by  use  of  the  pseudo-op  .CREATI. 

As  previously  mentioned,  if  the  cross-assembler  is  used  to  assemble 
this  file  the  appropriate  disk  instruction  file  will  be  created.  It  is  im- 
portant to  remember  however  that  no  architecture  file  should  be  read  before- 
hand, and  so  when  assembling  PMPINST  FORTRAN  the  file  PMP  ARCH  should  be  re- 
named (often  times  TEMP  ARCH  has  been  used). 
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C.  Creating  an  Architecture  File  for  PMP-I 

The  EXEC  file  for  PMP-1  cross-assemblies  names  a file  called  PMP  ARCH 
to  be  assembled  before  assembling  a user  source  program.  Thus  PMP  ARCH 
(which  appears  as  Appendix  G)  may  be  used  to  define  the  particulars  of  PMP-I. 

Naturally  the  first  statement  of  PMP  ARCH  must  be  a . DARCH , since  it  is 
this  pseudo-op  which  causes  the  cross-assembler  to  dynamically  allocate  neces- 
sary  storage  areas.  The  operands  of  .DARCH  are  clear,  since  PMP-I  is  a 60-bit 
machine  with  2K  of  program  memory,  and  for  which  the  instructions  have  been 
divided  into  12  canonic  classes  and  the  IC's  into  7 IC  classes.  Immediately 
following  comes  the  definition  of  the  pseudo-op  .DEFLTI  and  by  issuing  the 
.DEFLTI  pseudo-op  the  default  instruction  table  previously  created  from 
PMPINST  FORTRAN  is  retrieved  from  disk. 

The  12  canonic  classes  are  then  defined,  each  class  definition  consist- 
ing of  one  .DCLASS  pseudo-op  and  a . DOP  pseudo-op  for  each  allowable  operand. 
(Notice  that  canonic  class  1 allows  no  operands  and  therefore  no  .DOP  is 
used.)  Special  attention  is  drawn  to  the  fact  that  the  fourth  operand  of 
.DOP  actually  specifies  the  order  in  which  the  cross-assembler  examines  the 
list  of  available  operands.  In  particular,  this  implies  that  when  an  operand 
may  be  either  an  IC  or  something  else  the  other  possibilities  should  be 
checked  for  first,  otherwise  the  cross-assembler  will  incorrectly  attempt  to 
evaluate  an  operand  which  is  not  an  IC  as  an  IC. 

As  an  example  let  us  consider  the  definition  of  canonic  class  9.  From 
the  canonic  class  table  appearing  as  Appendix  B we  see  that  a class  9 in- 
struction may  have  2,  3,  or  4 operands,  the  first  of  which  must  be  either  an 
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immediate  constant  (IC)  or  Y,  and  the  remaining  operands  should  be  one  or  more 
from  the  set  {X,  S,  EO  K Therefore,  the  .DCLASS  pseudo-op  for  canonic  class  9 
specifies  at  least  2 operands  but  no  more  than  4 operands  may  be  coded,  and 
5 operands  are  included  in  the  operand  set.  The  final  operand  which  speci- 
fies any  required  operands  is  given  as  '20.  This  means  that  of  the  15-bit 
field  corresponding  to  this  operand  bit  11  is  =1,  i.e.,  of  the  operands  whose 
indices  are  1 and  2 at  least  one  must  be  coded. 

The  operands  of  canonic  class  9,  in  the  order  of  their  indices,  are  Y, 

IC,  X,  S,  and  EO.  Notice  that  the  last  operand  of  .DCLASS  specifies  that 
either  Y or  IC  must  be  the  first  operand  coded,  which  satisfies  the  canonic 
class  9 rule.  Also,  Y must  have  a lower  index  than  IC  (1  vs  2)  in  order  to 
prevent  the  cross-assembler  from  an  attempt  to  evaluate  Y as  an  immediate 
constant.  Both  Y and  IC  must  appear  as  the  first  operand  if  they  appear  and 
so  the  fifth  operand  of  . DOP  (numopcoded)  should  be  set  = 1.  The  order  of  X, 
S,  and/or  EO  is  not  important  and  therefore  numopcoded  is  given  as  zero  in 
these  cases. 

There  is  only  one  exclusivity  set  check  and  override  case  in  PMP-I,  the 
shift  instructions  (exclusivity  set  6).  The  .DEXCLC  pseudo-op  is  used  to 
indicate  that  if  two  instructions  of  exclusivity  set  6 are  coded  for  the  same 
program  memory  word  there  is  no  conflict  if  the  shift  bits  31-32  are  similar 
for  both  instructions. 

Only  one  translation  table  is  necessary,  the  translation  table  for  the 
shift  instructions.  The  .DTRANS  pseudo-op  allocates  1 translation  table  with 
4 entries,  and  the  . DTTAB  pseudo-op  is  used  to  fill  this  table  with  the 
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results  to  be  used  for  the  shift-count-bits  (bits  29-30  and  35-36)  as  indi- 
cated in  Appendix  D. 

D . Assembling  a User  Source  Program 

After  the  creation  of  PMPASM  EXEC,  PMP  ARCH,  and  PMPINST  FORTRAN'S 
assembly  to  create  the  instruction  table  on  disk,  the  burden  is  removed  from 
the  user.  The  user  need  only  invoke  the  PMPASM  EXEC  by  typing  the  CMS  command 

PMPASM  name  type 

where  name  and  type  are  respectively  the  filename  and  filetype  of  the  user's 
source  program.  All  appropriate  machine  definitions  occur  automatically, 
transparent  to  the  user's  program. 

A follow-up  program  has  also  been  generated  to  create  a paper  tape 
which  may  serve  as  input  to  PMP-I.  This  program  may  be  invoked  by  entering 
the  command: 

PMP  PUN  name 

where  name  is  the  same  filename  as  entered  in  the  assembly  process.  Eventual- 
ly a more  sophisticated  method  will  exist  whereby  the  user  may  send  the  ob- 
ject binary  directly  from  the  IBM  370  to  a minicomputer  which  in  turn  com- 
municates with  PMP-I,  but  this  system  does  not  yet  exist. 
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Appendix  A.  Definition  of  Terms  and  Concepts 
Following  is  a discussion  of  terms  and  concepts  which  appear  frequently 
in  the  text  of  this  report. 

1.  Canonic  class . Perhaps  one  of  the  most  fundamental  ideas  behind  the 


use  of  the  general  cross-assembler  is  defining  canonic  classes 


and  dividing  the  instructions  into  the  appropriate  canonic 
classes.  A canonic  class  is  formed  by  a group  of  instructions, 
all  of  which  have  the  same  list  of  allowable  operands.  The  sole 
difference  between  two  canonic  classes  is  that  some  difference 
exists  either  in  allowable  number  of  operands,  allowable  operands, 
or  action  taken  by  the  cross-assembler  (e.g.,  in  the  case  of  PMP-I, 
LRSR1  and  LRSB2  are  not  in  same  class  since  in  the  first  case 
the  cross-assembler  defines  Bl-shift  bits  and  in  the  second  case 
B2-shift  bits  are  defined). 

Cross-assemb ler . An  assembler  which  runs  on  one  machine,  but  assembles 
code  for  another  machine. 

Delimiter.  One  of  a set  of  special  control  characters  recognized  by 
the  cross-assembler.  This  set  consists  of  the  comma  (,),  semi- 
colon (;),  colon  (:),  slash  (/),  equals  (=) , and  blank  ( ). 
Delimiters  are  used  to  break  the  source  line  into  segments  (see 
Token)  . 


Exclusivity  Set.  This  concept  pertains  to  two  or  more  instructions 

which  are  mutually  exclusive,  i.e.,  they  nay  not  appear  in  the  same 
program  memory  word.  The  requirement  of  defining  exclusivity 
sets  arises  from  the  design  of  the  cross-assembler  for  micro- 
programmable  machines,  for  which  more  than  one  instruction  may 
be  coded  in  the  same  program  memory  location  as  long  as  conflicting 
sources,  destinations,  and/or  wires  are  not  required. 

1C  (Immediate  Constant).  The  term  IC  (or  Immediate  Constant)  refers 
to  an  operand  which  is  either  a numerical  constant  or  a symbolic 
label  (which  the  cross-assembler  converts  to  a numerical  constant). 

IC  Class.  An  IC  class  consists  of  a group  of  numerical  constants, 

bounded  by  botli  an  upper  and  a lower  limit.  In  addition  to  these 
limits  an  IC  class  has  associated  with  it  beginning  and  ending 
bit  numbers  which  specify  where  in  an  instruction  word  it  is  to 
be  placed.  Another  feature  allowed  in  an  IC  class  is  translating 
the  input  constant  by  means  of  a translation  table. 

Large  IC  Field.  The  "large  IC  field"  referred  to  in  the  text  is  the 
field  typically  used  to  hold  addresses  or  address  displacements. 

For  example,  on  the  PMP  this  would  be  hits  49  through  ftO  (with 
MSB  = 1);  on  the  Data  General  Nova  this  would  he  hits  H through 
15  (with  MSB  = 0) . 

Meta  language.  A language  used  in  the  definition  of  other  languages. 


9.  Opcode . An  operation  code,  which  specifies  operation  or  instruction  to 

be  performed.  Each  opcode  is  typically  represented  by  an  abbre- 
viation, or  mnemonic. 

10.  Operand ■ Typically  used  to  specify  either  sources  and/or  destinations 

for  an  operation  code.  For  example,  considering  the  PMP  instruction 
ADD1  A1,M  the  opcode  is  ADD1  and  operands  (in  this  case  destina- 
tions) are  A1  and  M. 

11.  PMP.  Parallel  Microprogrammable  Processor.  A high-speed  processor  de- 

signed for  digital  signal  processing  applications  at  Massachusetts 
Institute  of  Technology,  Lincoln  Laboratory. 

12.  Program  Counter.  The  term  program  counter  as  used  here  is  synonymous 

with  the  address  of  the  current  program  memory  location. 

13.  Pseudo-op . A command  which  controls  the  cross-assembler,  but  itself 

produces  no  executable  object  code. 

14.  Token . A character  string  separated  from  the  remainder  of  a source 

line  by  delimiters.  A token  may  contain  no  imbedded  delimiters. 

A token  will  be  either  a label,  opcode,  or  operand. 

15.  Trans  1 at  icin  TabJ_e.  Used  to  convert  the  actual  IC  coded  by  a programmer 

to  the  bit  string  placed  in  a program  memory  word,  if  the  two  are 
not  equivalent.  An  optional  offset  may  also  be  specified,  which  at 
assembly  time  is  added  to  the  coded  1C  before  using  that  number  as 


the  index  to  the  appropriate  translation  table  index. 
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APPENDIX  C.  IC  Classes  and  Translation  Tables  for 


IC  Class  It 

Limits 

Beginning 
Bit  It 

Ending 
Bit  It 

1 

-2048  < IC  < 2047 

49 

60 

2 

0 < IC  < 2047 

49 

60 

3 

0 < IC  < 1023 

49 

60 

4 

0 < IC<  4095 

49 

60 

5 

1 < IC  < 4 

49 

60 

6 

1 <■  IC  < 4 

29 

30 

7 

1 < IC<  4 

35 

36 

TABLE  1 

IC  TRANSLATION 

Table 

Entry  Table 

Value 

1 3 

2 1 

3 2 


PMP-I 

Translat ion 
Table  « 

0 (None) 

O(None) 

O(None) 

O(None) 

0 (None) 

1 


4 


0 


APPENDIX  D.  PMP-I  P retrain  Memory  Bi t Assignments 


MSB 


PE  CONTROL  BITS 


KILL.  ^PEAS 

CONTROL 

OPCODE 

3 (I  3 940  41  4349 


SHIFT 


i 


ALU1 

ALU  2 

RAM 

M 

SPECIAL 

0 

B1 

B2 

M 

A2 

7 

1 3 

1 6 

1 9 

2 5 

7 7 

3 1 3 3 

3 7 

3 8 

Note : In  the  descriptions  below,  [ ] stands  for  "contents  of  register' 


Bit  Description  of  Control  Funct i on 


l 

S3 

for 

ALU1 

2 

S2 

for 

ALU1 

3 

S1 

for 

ALU  1 

4 

so 

for 

ALU1 

5 

c 

n 

for 

AI.U1 

6 

M 

for 

ALU1 

7 

S3 

for 

ALU2 

8 

S2 

for 

ALU2 

9 

S1 

for 

ALU2 

10 

so 

for 

ALU2 

11 

c 

n 

for 

ALU2 

12 


M for  ALU2 . 


■ 


Bit 

13 

14 
13 


16 


17 

18 


19 

20 


21 


22,23,24 


Description  of  Control  F unction 

Selects  input  data  for  RAM.  If  1,  select  [I].  If  0,  select  [Ml. 
Write  pulse  to  PE  RAM. 

Selects  data  for  recirculating  bus.  If  1,  select  [Ml.  If  0, 
select  RAM  output. 

Selects  input  data  for  M.  If  0,  select  ALU1  output.  If  1, 
select  ALU2  output. 

Clock  M register. 

Causes  data  in  M to  be  left-shifted  1 bit.  The  shift  is  logical 
unless  control  bits  22,  23,  24  are  set  to  '110',  in  which  case 
the  inverted  sign  bit  of  ALU1  is  shifted  in  as  the  LSB. 

Clock  ALU1  sign,  overflow,  equal,  and  carry  flip-flops. 

If  ALU1  is  set  for  F=A1  and  bit  20=1,  F=A1  if  sign  flip-flop  = 0, 

F=B!  if  s n flip-flop  = 1.  (Used  to  find  larger  of  [All  and  [Bll.) 

If  AI.U1  is  set  for  F=B1  and  bit  20=1,  F=B1  if  sign  flip-flop  = 0, 

F=A1  if  sign  flip-flop  = 1.  (Used  to  find  smaller  of  [ A1 ] and  [B1J.) 

Selects  sign,  overflow,  equal,  and  carry  flip-flops  for  possible 
clocking  into  B2. 

These  special  bits  are  decoded  as  follows: 

001 :A2  is  clocked  if  sign  bit  of  M is  1 

010:A1  is  clocked  if  ign  bit  of  M is  1 

01 1 : A 1 and  A2  are  clocked  if  sign  bit  of  M is  1 

100 :0peration  in  ALU2  is  changed  if  F=A+B  is  chosen  so  that  F=B 

if  sign  of  [B2]=0,  F=MINUS  B if  sign  of  [ B2 ] = 1 . 


Bit 

22,23,24 


25 


26 


27 


28 

29,30 


31,32 


Description  of  Control  Function 

101 :A1  and  A2  are  clocked  if  the  sign  bit  of  ALU1  is  0. 

110:The  sign  bit  of  ALU1  is  inverted  and  clocked  into  LSB  of  M if 
bit  18=1.  A1  is  clocked  if  sign  bit  of  ALU1  is  0. 

111:A2  is  clocked  if  sign  of  M is  0.  M is  logically  left-shifted 
1 bit  unless  sign  of  [M]  = 1. 

The  0-register  is  unconditionally  loaded  (based  on  bit  15) , and  an 
external  interrupt  is  generated. 

If  sign  of  ALU1  is  1;  0-register  is  loaded  (based  on  bit  15), 
busy  flip-flop  is  set,  and  an  external  interrupt  is  generated. 
Selects  input  for  Bi . If  1,  recirculating  bus  is  chosen.  If  0, 

B1  shifter  is  chosen. 

Clocks  Bl  with  the  data  selected  by  bit  27. 

Data  in  Bl  is  clocked  into  Bl  shifter,  and  shifted  1,2,3,  or  4 
places  right.  Sign  bit  is  filled  according  to  bits  31,  32.  Number 
of  shifts  is  given  by  bits  29,  30  as  follows: 

00- shift  4 bits 

10- shift  3 bits 

01- shift  2 bits 

11- shift  1 bit 

These  bits  determine  the  type  of  shifting  done  in  both  shifters 
according  to: 

00 : ar ithmet ic  right  shifting  (Sign  bit  is  shifted  into  itself  and 
next  LSB) . 
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Bit  Description  of  Control  Function 

31,32  OlrCircular  right  shifting  (LSB  becomes  MSB). 

lX:Logical  right  shifting  (Shift  zeroes  into  MSB). 

33  Selects  input  for  B2.  If  1,  recirculating  bus  is  chosen.  If  0, 

B2  shifter  is  chosen. 

34  Clocks  B2  with  the  data  selected  by  bit  33. 

35,36  Data  in  B2  is  clocked  into  B2  shifter,  and  shifted  1,2,3,  or  4 
places  right.  Sign  bit  is  filled  according  to  bits  31,  32. 

Number  of  shifts  is  controlled  by  bits  35,  36  as  follows: 

00- shift  4 bits 

10- shift  3 bits 

01- shift  2 bits 

11- shift  1 bit 

37  Clocks  A1 , loading  output  of  ALU1. 

38  Clocks  A2,  loading  output  of  ALU2 . 

39  Kill  bit.  If  =1  when  a jump  is  taken,  the  instruction  pipeline 

is  killed. 

40  PE  address  select  bit.  If  =1  the  PE  RAM  address  is  given  by  [ S ] . 

If  0,  PE  RAM  address  is  given  by  the  IC  field  of  the  program  memory 
word . 

41-48  Control  opcodes.  For  a complete  listing  of  the  current  assignments, 
see  Reference  [2]  Appendix  A. 

49-60  Immediate  Constant  (IC)  field. 
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APPENDIX  E.  PMP-I  Exclusivity  Sets 


1 

2 

3 

4 

5 

6 

7 

8 

9 

in 

PE 

RAM 

ACCESS 

B-REG. 

SHIFT. 

RECIRC 

BUS 

USED 

CONTR . 
TYPES 

ALU  2 

ALU1 

Exclusivity  Set 
1-4 

5 

6 


7 

8 

9 

10 


Descr ipt ion 

Not  used. 

Instructions  that  require  a PE  RAM  access.  This 
includes  M0V1,  WR,  READ,  WRS,  READS. 

The  B-register  shift  instructions.  Recall  that 
the  rule  applying  to  these  is  that  a shift  may  he 
done  simultaneously  in  both  B-registers  only  if 
the  same  type  is  done  in  both.  Thus  a .DEXCLC 
(Define  Exclusivity  Set  Check)  pseudo-op  will  be 
used  for  the  bits  which  indicate  the  type  of 
shifting  to  be  done. 

Instructions  using  the  recirculating  bus. 

This  consists  of  MOVM,  READ,  and  READS. 

This  set  consists  of  all  controller  instructions, 
of  which  only  one  per  program  memory  word  may  be 
coded . 

All  instructions  using  ALU2. 

All  instructions  using  ALU1. 


APPENDIX  F.  EXEC  File  for  a PMP-I  Cross  Assembler 


FILE:  PHPASH  EXEC 


1/12/77  09:39  B.I.T.  LINCOLN  LABORATORY 


6CONTEOL  ERROR 

CP  LINK  PLIOPT  191  199  RE 

ACCESS  199  Z/Z 

GLOBAL  TXTLIB  SYSLIB  PLILIB  FORTLIB  GRLL 
FI  ARC  FI LE  DISK  PHP  ARCH  (LRECL  80  BLOCK  800  RECFH  FB 
FI  SFILE  DISK  61  62  63  (LRECL  80  BLOCK  800  RECFH  FB 
FI  ADR  FI LE  DISK  PHPADR  DATA  (BLOCK  80  RECFH  »B 
FI  WFILE  DISK  61  LISTING  (LRECL  133  BLOCK  133  RECFH  F 
FI  B IN  FI IE  DISK  61  OBJECT  (LRECL  80  BLOCK  800  RECFH  FB 
FI  TFILE  TEPHINAL  (LRECL  132 

FI  INSFILE  DISK  PMPINS  DATA  (LPECL  80  BLOCK  800  RECFH  FB 
LOAD  GENASM  GENHASH  GENBILD  (NOHAP  NODUP  START 
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APPENDIX  G.  Architecture  Definitions  for  PMP-I 


FILE:  PMP 

ARCH  A 12/21/76  09:44 

H.I.T.  LINCOLN  LABORATORY 

. D AFCH 

60,0,2048,12,7 

PMP00010 

. DEFI 

.DEFLTI='0,0,0,0,0,1,0,4 

PMP00020 

. DEFLTI 

PMP000  30 

. DC! ASS 

1,  0,0, 0, 0 

PMP00040 

. DCLASS 

2, 1,1,1,  1 

PMP00050 

• DOP 

IC, '0,2, 1,1,1 

PHP00060 

. DCI ASS 

3,  1,2,2, 0 

PNP00070 

• DOP 

A1  , '0000000000004,3,1,0 

P(1  PO  00  80 

.DOP 

M, *000002,3,2,0 

PH  PO  0090 

.DCLASS 

4, 1,2, 2,0 

PH  PO0 1 00 

.DOP 

A2, '0000000000002,4,1,0 

PHP001 10 

.DOP 

M, • 000006,4, 2,0 

PH  PO  01  20 

•DCLASS 

5,1  ,3.3,0 

PM  PO  01 30 

.DOP 

X, • 0000000000000004,5,1,0 

PH  POO  1 40 

.DOP 

S, ' 0000000000000002, 5,2,0 

PH  PO  0 1 50 

.DOP 

EO, '0000000000000001 ,5,3,0 

PMP001 60 

.DCLASS 

6, 2,4, 4,0 

PM  PO  0 1 70 

• DOP 

IC, *0,6, 1,1, 3 

PM  PO  01  80 

• DOP 

B1, '0000000014,6,2,0 

PM  PO  0 1 90 

.DOP 

B2,  '000000000014,6,3,0 

PMP00200 

• DOP 

0, ' 000000004,6,4,0 

PHP00210 

.DCLASS 

7,1. 1.2,0 

PH  POO 2 20 

.DOP 

IC, *0,7, 2, 1,1 

PM  PO  02  30 

• DOP 

I, • 0000000000000001,7,1,1 

PH  PO  0 240 

.DCLASS 

8, 1,1, 2,0 

PHP00250 

.DOP 

IC, '0,8. 2, 1,1 

PHP00260 

• DOP 

El, '0000000000000001,8,1,1 

PHP00270 

.DCLASS 

9, 2. 4, 5, *20 

PHP002  80 

. DOP 

Y, • 0000000000000010,9, 1,1 

PHP00290 

.DOP 

IC.  *0,9, 2, 1,1 

PH.  POO  300 

.DOP 

X, *0000000000000004,9,3,0 

PH  PO  03 1 0 

• DOP 

S, '0000000000000002,9.4,0 

PH P00320 

.DOP 

EO,' 000000000000000 1,9, 5,0 

PHP003 JO 

.DCLASS 

10,1,3,3,0 

PHP00340 

.DOP 

B1  , '0000000014,10,1,0 

PMP00350 

• DOP 

B2, *000000000014,10,2,0 

PHP00360 

• DOP 

0, '000000004, 10, 3,0 

PHP00370 

. DCI ASS 

11.1,1.1.0 

PHP003  80 

.DOP 

IC, '0.  11,  1,1,6 

PH P00390 

•DCLASS 

12,1,1.1,0 

PHP00400 

• DOP 

IC, *0,12, 1,1.7 

PHP004  10 

. DEXCLC 

6,31,32 

PH  PO  04  20 

•DTPANS 

1.  ** 

PHP00430 

. DTTAB 

1,0,1, 3, 1,2,0 

PH  PO 04  4 0 

.DEFIC 

1,-2048,2047,49.60,0 

PHP00450 

•DEFIC 

2,0,2047,49,60,0 

PH  PO  04  60 

•DEFIC 

3,0,1023,49,60.0 

PHP00470 

.DEFIC 

4,0,4095,49,60,0 

PH  POO 4 80 

•DEFIC 

5,  1 ,4 ,49,60,0 

PH  PO  04  90 

•DEFIC 

6,1,4,29,30,1 

PHP00500 

•DEFIC 

7,  1 ,4,35,36, 1 

PHP00510 

1 


I 

- 
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APPENDIX  H.  Instruction  Table  File  for  PMP-I 
FILE:  PHPINST  FORTRAN  A 2/08/77  14:29  H.I.T.  LINCOLN  LABORATORY 

. DAFCH  60,0,20  48, 12,7 
.DEFI  .DEPIC='0,0,0,0,0,  1,0,  1 
.DEFI  .DCLASS='0,0,0,0,0,1,0,3 
.DEFI  .DOP='0,0,0,0,0,1,0,6 
.DEFI  .DEFLTI='0,0,0,0,0.1,0,4 
.DEFI  .CREATI='0,C, 0,0,0, 1,0,5 
.DEFI  .DTTAB='0,0,0,0,0,1,0,8 
.DEFI  .DTRANS= '0 ,0 ,0,0, 0,1 ,0,9 
.DEFI  .LOC=' 0, 0, 0,0,0, 1,0, 10 

• DEFI  .DEFC=' 0,0, 0,0, 0,1,0,  11 

.DEFI  .DEXCLC=' 0,0, 0,0,0, 1 , 0,12 
.DEFI  .DIBASE- *0,0,0,0,0,1,0,13 
•DEFI  . DOBASE='0,0,0,0,0,1,0,14 
.DEFI  BHPY=* 464 60 103, 3, 0,0, 0,0, 0,1 
.DEFI  LLS(!  = ' 000 001, 0,0, 0,0, 0,0,1 

•DEFI  FFB2=' 000000 100 004, 0,0,0, 0,0, 0,1 
.DEFI  CAB=* 3000004. 1 ,0,0, 0,0,0, 1 
.DEFI  CHO=' 30001 0002, 1,0, 0,0, 0,0,1 
.DEFI  BHPY1='  46000102,  1 , 0,  0,  0,  0 , 0,  1 
.DEFI  BMPY2=' 00460101, 2, 0,0, 0,0,0,  1 
.DEFI  BDIV= ' 30000106, 1,0,0, 0,0, 0,1 

.DEFI  BFIX= '7651000500474, *23,0,0,0,0,0,  1 
.DEFI  BFLO=' 00000007,0,0,0,0,0, 0, 1 
.DEFI  HO VI=' 00006, '40, 3, 1,0, 0,0, 2 
•DEFI  WR='00002,'40,3, 1,0, 0,0, 2 
.DEFI  NR S=' 0000200 0000004, '4 0,0, 0,0, 0,0, 1 

.DEFI  ARSB1=' 0000000004, '20,6,0,0,0,0,11 
.DEFI  ARSB2*' 00Co  ‘ 00 0004 , • 20, 7, 0, 0, 0, 0,  1 2 
.DEFI  LPSB1=' 00000000044, • 20,6,0,0,0,0,11 

• DEFI  LR  SB2  ='  000000000044, • 20, 7, 0, 0, 0, 0,  12 

. DEFI  LEARSB1  = '00000000042,'20,6,0,0,0,0,11 

.DEFI  LEARSB2-'0 00 000000024, '20, 7, 0,0, 0,0, 12 

.DEFI  LAB=' 5100002,1,0,0,0,0,1, 3 
.DEFI  SAB='7500002,1,0,0,0,0,1,3 

• DEFI  flOVAl  = ' 75 ,1 ,0, 0,0,0, 1,  3 

.DEFI  HOVA2=' 0075, 2, 0,0,0, 0,1,4 
.DEFI  HO VB1S* 51, 1,0, 0,0, 0,1, 3 

.DEFI  H0VB2=' 0051, 2, 0,0, 0, 0,1,4 

• DEFI  CO HA1-' 01, 1,0, 0,0, 0,1, 3 

.DEFI  COn A2=* 0001,2, 0,0, 0, 0,1,4 
.DEFI  COHB1='25, 1,0, 0,0, 0,1,3 
.DEFI  COHB2=' 0025, 2, 0, 0, 0, 0, 1,4 
.DEFI  OR1  = '71 , 1 ,0,0, 0,0, 1 , 3 

.DEFI  OR2=' 0071, 2, 0,0, 0,0, 1,4 
•DEFI  AND1='55,1,0,0,0,0,1,3 
.DEFI  AN D2= '0055, 2, 0,0, 0,0, 1,4 
•DEFI  XOR1='31,1,0,0,0,0,1,3 
.DEFI  X0R 2= '0031, 2, 0,0, 0,0, 1,4 


.DEFI 

ADD1='46, 1,0, 0,0, 0,1,3 

.DEFI 

ADD 2- '0046, 2, 0,0, 0,0, 1,4 

.DEFI 

SUB1='30, 1,0, 0,0, 0,1,3 

• DEFI 

SO B2=' 0030, 2, 0,0, 0,0, 1,4 

• DEFI 

LLSA1='62, 1,0, 0,0,0, 1, 3 

• DEFI 

LLSA2  = '0062,2,0,0,0,0,  1,4 

1 

K 

• DEFI 

ZRO 1 = • 14,1,0,0,0,0,1,3 

r , 

L 
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FILE:  PMPINST  FORTRAN  A 2/08/77  14:29  M.I.T.  LINCOLN  LABORATORY 


.DEFI  ZR02='0014,2,0,0,0,0, 1,4 
. PER I ONES1=< 16, 1,0, 0.0, 0, 1,3 
.DEFI  ON ES2  = * 00 16, 2, 0,0, 0,0, 1,4 

•DEFI  ABSB='  004  60004, 2, 0,0, 0,0, 1 ,4 

•DEFT  READ* *0 , *50,3, 1 ,0,0, 0,6 
.DEFI  NO VN=' 0000 1, • 10,0,0,0,0,0,10 
.DEFI  AD D = '0, 4, 1,0, 0,0, 0,9 

.DEFI  JHPX= ' 0000000000000010,4, 0,0,0 ,0 ,0 , 1 
.DEFI  JMKX= • 0000000000001010,4,0,0,0,0,0,1 
.DEFI  SUB='00000 00 000000020,4, 1,0, 0,0,0, 9 

.DEFI  MO VSY= *0000000000000030, 4 , 0, 0,0,0, 0,1 

.DEFI  LLSY4  = '00000 000000 00040,  4, 0,0,  0,0,  0,  1 

.DEFT  AN D = ' 0000000000000040,4, 1 , 0,0, 0,0, 9 

.DEFI  DPEADY='OOOC000000000126,4,0,0,0,0,0,1 
.DEFI  DR EADXY  = ' 000 000000 000 012 7, 4, 0,0, 0,0,0,  1 

.DEFT  OR= '0000 0000 00000060,4, 1,0, 0,0, 0,9 

.DEFI  NXTREAD-'  0000000000000131 , 4,  0,  0,0, 0,0,  1 
.DEFI  EN  A BL  = ' 0 0000 00 000 000 1 0 0, 4 , 0,0,  0,0, 0,1 

•DEFI  XO R=* 000 0000 00 0000 100, 4, 1 , 0, 0, 0,0, 9 
.DEFI  DS A BL  = * 00000000000001 1 0,4, 0,  0,  0,0,0,  1 
.DEFI  PS  A VS=* 0 0000 00 0000 00 12 0,4, 0,0,  0,0, 0,1 

.DEFI  LDX  = '0 00 0000 0000 00 130, 4,  1,1, 0,0,0,  2 

.DEFI  REA DS  = ' 00000000000004, • 50, 0,  0,  0,0,  0,  10 

.DEFI  JHP=' 0000000  0000 0.0 020 ,4,2,1,  1,0,  1,  2 

.DEFI  NOV  X= ' 0000000000000140,4,0,0,0,0,0,5 
.DEFI  JNK  = ' 000 0000 00 000 10 20, 4, 2, 1, 1,0, 1, 2 

.DEFI  HO V Y=*  000000 00 0000 0150, 4, 0,0, 0,0, 0,5 

.DEFT  JNPXL- '0000000000000137, 4, 2,  1,  1,0,  1,2 
.DEFI  IN CX=' 0000000000000160,4,0,0,0,0,0,5 

• DEFI  JMKXL  = ' 0000000000001  137, 4,2,1  , 1 .0,  1 ,2 

.DEFI  DECX=' 000000 00 000001 70, 4, 0,0, 0,0, 0,5 

.DEFT  ON PXF='  0000000000000136, 4,2, 1 , 1 ,0, 1 ,2 
•DEFI  I LSX= '0000000000000200,4,0,0,0,0,0,5 
.DEFI  CONP=' 000 000 00000002 10, 4, 1,0, 0,0, 0,7 

.DEFT  »EMX= '0000000000000212,4,3,0,0,0,0,7 

• DEFI  M EM Y='  000000  000000  0214,4,3 ,0,0.0, 0 ,7 

.DEFI  ST  A S= ’ 0000000000000216,4, 3, 0,0, 0,0, 7 

• DEFI  LBS  = ' 0000000000000220,4,1  , 0,0, 0,0, 8 

.DEFI  LDEI= '0  0000000 00000222, 4, 0,0, 0,0, 0,1 
•DEFI  LDEIB=' 0000000000000223,4, 0, 0, 0,0, 0, 1 

• DEFI  LDEO=  *0000000000000224,4,1  ,1,0,0,0,2 

.DEFI  JNKXE  = ' 0000000000001  136, 4, 2,  1,  1,0,  1,2 

.DEFI  JN PXG=' 0000000 000000 140, 4, 2, 1 , 1 ,0, 1 ,2 
.DEFI  JMKXG=  *00000 00000001  140,4, 2,  1,  1,0,  1,2 

• DEFI  JHPAL  = ' 00000 00 0000 00 13 3,  4, 2,  1,  1,0,  1,2 

.DEFI  JHKAL=' 0000000000001133,4,2,1,1,0,1,2 
.DEFI  JKPAE=* 00000 00000000132, 4, 2, 1,1, 0,1, 2 

.DEFI  JFK  AE  = * 0000000000001  132,4,2,1, 1,0, 1,2 

.DEFI  JN PAG ='00000000000 00 13 4, 4,  2,  1,  1,0,  1,2 
.DEFI  JNK AG  = ' 0000000000001  1 34 , 4 , 2,  1 , 1 , 0,  1 , 2 

.DEFI  JNPTX  = ' 0000000000000135,4,2, 1 , 1 ,0,  1 ,2 
.DEFI  JMKTX=' 0000000000001 135, 4,2, 1, 1,0, 1, 2 

• DEFI  JNPOVF=*  0000000000  000160,4,2 ,1  ,1  ,0,1 ,2 

.DEFI  J«KOVF=' 0000 OC 0000001  160, 4, 2,1  , 1 ,0, 1, 2 
.DEFI  DP  EADX  = ' 0000 00 0000 00 01 25 ,4, 1 , 1 ,0,0 , 0, 2 
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Instruction  Table  File  for  PMP-I  (Continued) 

FILE:  PMPINST  FORI  BAN  A 2/08/77  14:29  M.I.T.  LINCOLN  LABORATORY 


• DEFI  CL  RIO -'00000 00000000236,4, 4,1 , 0,0, 0,2 

-DEFI  SET  10  = ' 0000000000000231, 4, 4,  1,  0,0, 0, 2 
.DEFI  SET MUX  = ' 0000 00 0000 0002 34 , 4,4 ,0 ,0,0 ,0,7 

•DEFI  MS K IO= '00000 000000 002 32, 4, 4,0, 0,0, 0,7 

.DEFI  HA LT=' 000000 00 0000 02 30, 4, 0,0, 0,0,0, 1 

.DEFI  SET AUX=' 0000000000000237,4,0,0,0,0  ,0,1 
.DEFI  CLF AUX= '0000000000000240,4,0,0,0,0,0, 1 
.DEFI  JMKCEI  = * 000000  0000001 122, 4, 2, 1 , 1 , 0 , 1, 2 
.DEFI  JMKDEO=' 0000000000001 123,4,2 ,1  , 1 ,0 ,1 ,2 
.DEFI  JMKDHP=' 0000000000001 124, 4,2, 1 , 1 ,0 , 1 , 2 
.DEFI  Jf1PDEI=*  0000  00  0000  00  01  22, 4, 2,1  ,1,0, 1,2 

.DEFI  JMPDEO= '0000000000000123,4,2,1,1,0,1,2 
.DEFI  JMPDHP='00000000000001^4,4,2,  1 , 1,0  , 1, 2 
.DEFI  LDPM=' 0000 000000000050, 4, 5,1 ,0,0, 0,2 

.DEFI  PI  NTS  = ' 0000000000000121, 4, 0,0, 0,0, 0,1 
.DEFI  JMPXN  E=*  0000000000000*25,4 ,2,1  ,1  ,0 ,1 ,2 
.DEFI  JHKXNE= '000000  0000001225, 4,2,1  , 1 ,0,  1, 2 
.DEFI  JM P XL E=' 0000000000000226,4,2, 1 , 1,0,  1, 2 

' .DEFI  JMKXLE=' 0000000000001226, 4,2 ,1  ,1  ,0 ,1  ,2 

.DEFI  JNPXGE=* 0000000000000227, 4, 2,1  , 1 ,0 , 1, 2 
.DEFI  JHKXGF=' 0000000000001227, 4,2.1  ,1  ,0 ,1 ,2 
■ DEFI  I.LS4=  *0000000000000060,4,  1 , 1 ,0,0,0, 2 
.DEFI  SW  APS  Y = ' 000000  000000  0070,4,0,0,0,0,0,1 

.DEFI  MO VSYXS= '000 00 000000 00150, 4, 0,0, 0,0, 0,1 

-DEFI  LE ASX ='000 00 00 000 000240, 4, 0, 0, 0,0, 0,5 
.LEFT  ME" XSY=* 0000000000 000* 50, 4, 3, 0,0, 0,0, 7 

•DEFI  ME MXMSY= '0000000000000252, 4, 3, 0, 0, 0, 0, 7 

• DEFI  HEM  XS  = ' 0 0000 00 0000 00 2 c 4, 4 ,3,0, 0,0, 0,7 

.DEFI  I NCXMX=' 0000 00 00000002 56, 4, 3, 0,0, 0,0, 7 
.DEFI  MOVXSTS=’ 000 0000 0000 OC 26 0 , 4 , 3, 0, 0, 0, 0,7 

.DEFT  INC XSTS-'OOO 0000000000262, 4,3, 0,0, 0,0, 7 
. CPF  AT  I 
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APPENDIX  I.  Sample  Program  Listing  (Continued ) 

CROSS  REFERENCE  TABLE 


NAME 

ADDRESS 

DEFINED 

FEFERENCES 

LOG_BEG 

00021 

101 

LOG_LOO 

00023 

105 

140 

M AG_BEG 

00000 

45 

MAG_LOO 

00002 

48 

62 

EM344 

00344 

23 

146 

P M 3 45 

00345 

24 

143 

RM364 

00364 

25 

144 

RM365 

00  365 

26 

145 

RM6  0 

00060 

21 

110 

PM6  1 

00  061 

22 

120 

0 STATEMENTS  FLAGGED  IN  THIS  ASSEMBLY 


APPENDIX  J Error  Messages  Produced  at:  Assembly  Time 
Following  is  a description  of  all  error  messages  produced  by  the  cross- 

assembler,  with  possible  corrective  actions  suggested.  All  error  messages 

are  output  immediately  before  the  source  line  producing  the  error. 

1.  ** ** * exCLUS I V T TV  SET  CONFLICT 

Two  or  more  mutual  I y ex  !.u  r e instructions  have  been  coded  for 
the  same  program  memory  wed.  i , instructions  have  been  inclusive 
OR'ed  which  probably  resuit  , . n instruction  other  than  either  of 

the  two  conflicting  instructions. 

2.  *****MORE  THAN  1 IC  USED 

Two  instructions  intended  for  the  same  program  memory  word  require 
the  use  of  the  large  IC  field.  The  two  IC's  have  been  inclusive  OR'ed, 
probably  producing  a third  IC. 

3.  ***** ILLEGAL  COMBINATION 

Two  instructions  are  trying  to  set  the  same  bit,  typically  indicating 
multiple  use  of  registers,  wires,  etc.  The  instructions  will  still  be 
OR'ed,  with  proper  execution  doubtful. 

4.  *****SOURCE  PROGRAM  TOO  LONG 

An  attempt  was  made  to  assemble  code  for  a memory  location  whose 
address  is  greater  than  the  upper  limit  specified  by  the  .DARCH  pseudo-op. 
Assembly  is  terminated. 

5.  *****UNDEFINED  LABEL  name 

A forward  reference  was  made  to  an  IC  called  name , but  at  the  end 
of  assembly  the  value  of  name  had  not  yet  been  defined. 
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6. 


*****UNKNOWN  OPCODE  opcode 


The  instruction  mnemonic  opcode  was  coded,  but  it  does  not  appear 
in  the  table  of  defined  instruction  mnemonics. 

7.  ***** INVALID  OPERAND  operand  for  opcode 

The  instruction  mnemonic  opcode  appeared  with  operand  coded  as  an 
operand,  but  operand  is  not  an  element  of  the  operand  set  for  this 
instruction,  operand  is  ignored. 

8 . ***** INSTRUCT ION  opcode  ALREADY  DEFINED 

A .DEFI  attempted  to  define  the  instruction  mnemonic  opcode , but 
opcode  has  already  been  defined.  The  new  definition  will  be  ignored. 

9.  ****INSTRUCTION  TABLE  FULL 

An  attempt  to  define  an  instruction  mnemonic  with  a .DEFT  was  made, 
but  there  was  nr.  room  in  the  instruction  table  for  this  mnemonic.  The 
.DEFI  will  be  ignored. 

10.  *****INVALTD  CANONIC  CLASS  FOR  opcode 

A .DEFI  pseudo-op  attempted  to  define  the  instruction  menmonic 
opcode , but  spei  if  ied  that  opcode  belonged  to  a nonexistent  canonic 
class  (where  number  of  canon!  s specified  in  the  . DARCH 

pseudo-op) . 

11.  *****INVALID  ATTEMPT  TO  CHANGE  ADDRESS 

The  operand  of  the  .LOG  pseudo-op  is  invalid.  Usually  this  indi- 
cates either  an  attempt  to  set  the  address  counter  to  a value  less 
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than  the  current  value  or  to  a value  greater  than  the  maximum  program 
memory  location  as  specified  by  the  .DARCH  pseudo-op. 

12.  *****CONSTANT  operand  OUT  OF  LIMITS 

The  immediate  constant  operand  is  outside  the  limits  for  the  current 
instruc  t ion . 

13.  *****MISSINC,  OPERAND  FOR  opcode 

The  instruction  opcode  has  been  coded  with  an  insufficient  number 
of  operands.  Depending  on  the  instruction  mnemonic  the  cross-assembler 
may  or  may  not  examine  operands  that  were  coded. 

14 . *****T00  MANY  OPERANDS  FOR  opcode 

The  instruction  mnemonic  opcode  has  more  than  the  maximum  allowable 
number  of  operands.  Only  the  first  n operands  will  be  examined,  where  n 
is  the  maximum  number  of  allowable  operands. 

15.  *****INVALID  EXCLUSIVITY  SET  FOR  opcode 

An  attempt  to  define  opcode  with  a .DEFI  pseudo-op  contains  an 
illegal  exclusivity  set  value.  The  definition  of  this  instruction 
mnemonic  is  ignored. 

16.  *****REQUIRES  operand l OR  operand2 

Either  operand  1 or  operand  2 is  required  for  this  instruction 
mnemonic  but  was  not  coded.  The  available  operands  are  assembled. 
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17.  *****WRONG  PLACE  FOR  OPERAND  operand 

operand  is  a valid  operand  for  the  current  instruction  and  its 
position  in  the  list  of  operands  is  essential  to  its  meaning.  The 
instruction  appears  here  with  operand  coded  but  not  in  the  proper  posi- 
tion. The  cross-assembler  will  ignore  operand . 

18.  *****INVALID  OCTAL  STRING  FOR  name 

name  is  either  an  opcode  being  defined  with  a .DEFT  pseudo-op  or  an 
operand  being  defined  with  a .DOP  pseudo-op.  The  actual  bit  string  value 
to  be  assigned  to  name  must  be  coded  as  an  octal  constant  beginning  with 
an  apostrophe  ('),  but  is  coded  illegally  here.  The  .DEFI  or  .DOP  is 
ignored  . 

19.  *****RF.SERVED  MNEMONIC  name  USED  AS  CONSTANT 

name  is  a reserved  mnemonic  but  the  user  has  attempted  to  use  it 
either  as  a label  or  as  an  operand  which  must  be  an  immediate  constant. 

If  it  is  being  defined  as  a label  the  definition  is  ignored  and  if  name 
appears  as  an  operand  a value  of  zero  is  used. 

20.  *****name  MULTIPLY  DEFINED 

Either  name  is  a label  being  defined  which  already  has  been  defined 
or  a reference  is  being  made  to  a label  for  which  multiple  definitions 
have  been  given.  If  a definition  is  being  given  it  will  be  ignored,  and 
thus  a reference  to  a multiply  defined  label  will  retrieve  the  value  first 
assigned  to  that  label. 
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21.  *****SYMBOL  TABLE  OVERFLOW  FOR  name  r 

An  attempt  to  define  the  label  name  was  unsuccessful  since  there  was 
no  longer  any  room  available  in  the  symbol  table.  The  user  will  need  to 
omit  some  labels.  Currently  the  number  of  symbols  allowed  is  1023  minus 
the  number  of  reserved  mnemonics. 

22.  *****UNKN0WN  CONSTANT  name 

A reference  to  name  appeared  but  name  has  not  yet  been  defined  and 
the  current  instruction  does  not  allow  forward  referencing.  A value  of 
zero  will  be  used. 

23.  *****INVAI.ID  CONSTANT  name 

The  immediate  constant  name  was  coded  but  cannot  be  deciphered.  Typi- 
cally this  indicates  a numeric  constant  containing  a non-numeric  character 
or  a number  not  allowed  in  the  current  base. 

24.  *****CROSS-REFERENCE  TABLE  FULL 

A label  was  referenced  but  there  was  no  room  available  to  save  this 
in  the  cross-reference  table.  The  program  memory  word  is  assembled 
correctly,  but  the  cross-reference  listing  will  not  reflect  this  variable 
ref erenc  e . 

25.  ***** jc  LIMITS  EXCEEDED  BY  CONSTANT  WITH  FORWARD  REFERENCES  AT  ADDRESSES 

numbers 

This  message  is  produced  when  a label  which  has  been  forward 
referenced  is  defined  but  is  not  within  allowable  limits,  numbers  is  a 
list  of  all  addresses  where  this  label  has  been  referenced.  The  address 
fields  of  all  addresses  listed  will  not  be  updated. 
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APPENDIX  K.  ALU  Function  Select  Table 
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Each  bit  is  shifted  to  the  next  more  significant  position 


APPENDIX  L.  PMP-I  Processor  Element  (PE)  Architecture 
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